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FOREWORD 


四 十 不 惑 ,创新 不 止 


从 飞 铝 传 书 到 手机 沟通 ,从 钻 木 取 火 到 核能 发 电 , 从 日 行 千里 到 探索 太空 …… 和 曾经 遥 不 
可 及 的 梦想 如 今 已 经 变 为 现实 ,有 些 甚至 超出 了 人 们 的 想象 ,而 所 有 这 一 切 都 离 不 开 科 技 创 
新 的 力量 。 

对 于 微软 而 言 , 创 新 是 我 们 的 灵魂 ,是 我 们 矢志 不 渝 的 信仰 。 不 断 变革 的 操作 系统 ,日 
益 完 善 的 办 公 软 件 ,预见 未 来 的 领先 科技 …… 40 多 年 来 ,在 创新 精神 的 指引 下 ,我们 取得 了 
辉煌 的 成 绩 ,引领 了 高 科技 领域 的 突破 性 发 展 。 

IT 行业 不 墨守成规 ,只 尊重 创新 。 过 往 的 成 就 不 能 代表 未 来 的 成 功 ,我 们 将 继续 配 研 
前 行 。 如 果 说 ,以 往 诸如 个 人 计算 机 、 平 板 电脑 . 手 机 和 可 穿戴 设备 的 发 明 大 都 是 可 见 的 , 那 
么 ,在 我 看 来 ,未 来 的 创新 和 突破 将 会 是 无 形 的 “隐形 计算 ?就 是 微软 的 下 一 个 大 事件 。 让 
计算 归于 “无 形 ”, 让 技术 服务 于 生活 ,是 微软 现在 及 未 来 的 重要 研发 方向 之 一 。 

当 计 算 来 到 云端 后 , 便 隐 于 无 形 , 能 力 却 变 得 更 加 强大 ; 当 机 器 学 习 足 够 先进 ,人 们 在 
尽 享 科技 带 来 的 便利 的 同时 却 觉察 不 到 计算 过 程 的 存在 ; 当 人 们 只 需 通 过 声音 、 手 势 就 可 
以 与 周边 环境 进行 交互 ,计算 机 也 将 从 人 们 的 视线 中 消失 。 正 如 著名 科幻 作家 亚 巧 ， 查 尔 
斯 .克拉 克 所 说 :“ 真 正 先进 的 技术 ,看 上 去 都 与 魔法 无 异 。” 

技术 是 通 往 未 来 的 钥匙 ,要 实现 “隐形 计算 ”, 人 工 智能 技术 在 这 其 中 起 着 关键 作用 。 近 
几 年 ,得 益 于 大 数据 、 云 计算 、 精 准 算法 ,深度 学 习 等 技术 取得 的 进展 ,人 工 智 能 研究 已 经 发 
展 到 现在 的 感知 ,甚至 认 知 阶段 。 未 来 ,要 实现 真正 的 人 机 互动 .个 性 化 的 情感 沟通 ,计算 机 
视觉 .语音 识别 .自然 语言 将 是 人 工 智能 领域 进一步 发 展 的 突破 口 及 热门 的 研究 方向 。 

2015 年 7 月 发 布 的 Windows 10 是 微软 在 创新 路 上 写 下 的 完美 注脚 。 作 为 史上 第 一 个 
真正 意义 上 跨 设备 的 统一 平台 ,Windows 10 为 用 户 带 来 了 无 颖 衔接 的 使 用 体验 ,而 智能 人 
工 助理 Cortana、Windows Hello 生物 识别 技术 的 加 入 ,让 人 机 交互 进入 了 一 个 新 层次 。 
Windows 10 也 是 历史 上 最 好 的 Windows、 最 有 中 国 印记 的 Windows, 不 但 有 针对 中 国 本 土 
的 大 量 优化 ,还 有 海量 的 中 国 应 用 。Windows 10 是 一 个 具有 里 程 碑 意 义 的 跨 时 代 产 品 ,更 
是 微软 崇尚 创新 的 具体 体现 ,这 种 精神 渗透 在 每 一 个 微软 员工 的 血液 之 中 ,激励 着 我 们 “了 予 
力 全 球 每 一 人 、 每 一 组 织 成 就 不 凡 ”。 
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四 十 不 惑 的 微软 对 前 方 的 创新 之 路 看 得 更 加 清晰 , 走 得 也 更 加 坚定 。 希 望 这 套 从 书 不 
仅 成 为 新 时 代 中 微软 前 行 的 见证 ,也 能 够 助 中 国 的 开发 者 一 臂 之 力 , 共 同 繁荣 我 们 的 生态 系 


统 , 绽 放 更 多 精彩 的 应 用 ,成 就 


属于 自己 的 不 凡 。 


沈 向 洋 
微软 全 球 执行 副 总 裁 


-一 
有 后 
PREFACE 


经 过 10 多 年 的 发 展 ,Microsoft .NET Framework 已 经 相当 成 熟 ,拥有 强大 的 类 库 与 可 
视 化 框架 ,融合 了 许多 新 技术 。 在 Windows 平台 上 ,从 桌面 应 用 到 Web 应 用 都 能 完 
胜任 。 

.NET Core 是 在 原 . NET 框架 的 基础 上 开发 的 新 一 代 开 源 项 目 , 人 们 期 待 已 久 的 
.NET 跨 平 台 终 于 实现 (基于 . NET Core 开发 的 应 用 程序 可 以 运行 在 Windows、 Linux、 
Mac OSX 等 操作 系统 上 )。. NET Core 项 目 由 微软 官方 团队 、 第 三 方 开 发 团队 及 社区 用 户 共 
同 维护 。. NET Core 从 原 有 的 .NET Framework 抽取 出 最 基础 .最 核心 的 API 重新 开发 , 作 
为 . NET 的 新 标准 发 布 ,第 三 方 开发 人 员 可 以 在 此 标准 上 进行 自由 扩展 。 

本 书 所 有 内 容 均 以 实例 的 形式 呈现 ,容易 上 手 。 每 个 实例 都 包含 两 部 分 内 容 : 【导语 】 
部 分 主要 对 实例 中 要 用 到 的 核心 知识 点 进行 介绍 ;【 操 作 流程 ] 部 分 详细 讲述 完成 实例 项 目 
的 步骤 ,读者 可 以 直接 动手 实践 ,亲自 体验 编程 的 乐趣 。 

本 书 内 容 分 为 三 篇 : 

第 一 篇 ”基础 知识 。 涉 及 开发 环境 的 搭建 .基础 类 型 .流程 控制 .常用 集合 .LINQ 语法 
和 面向 对 象 思想 等 内 容 。 

第 二 篇 ”技术 进 阶 。 强 化 编程 技能 ,此 部 分 的 实例 包括 文件 与 目录 操作 ,基础 /O.、 序 
列 化 / 反 序 列 化 、 网 络 与 异步 编程 .反射 与 加 密 算 法 应 用 等 内 容 。 

第 三 篇 ”ASP. NET Core。 此 部 分 主要 包括 与 Web 开发 相关 的 实例 ,重点 涉及 Web 
Host 初始 化 、 中 间 件 、 依 赖 注入 、 应 用 配置 .EF Core 等 关键 知识 。 

笔者 曾 写 过 与 C# 编程 相关 的 书 , 写 作 此 书 的 想法 是 源 于 几 位 网 友 在 微 博 私 信 中 的 提 
问 , 经 过 一 番 振 酌 ,我 认为 有 必要 编写 一 本 与 . NET Core 有 关 的 书 , 毕 况 . NET Core 作为 全 
新 的 跨 平台 项 目 ,存在 不 少 新 的 特性 。 不 过 本 书 中 未 使 用 大 篇 幅 讲解 的 叙述 方式 ,而 是 采用 
以 单独 实例 驱动 为 主 ,以 知识 阐述 为 辅 的 方式 ,重点 在 于 调动 读者 积极 上 机 实战 的 兴趣 。 经 
常 有 初学 编程 的 朋友 问 我 : 为 什么 看 书 的 时 候 感 觉 自己 学 会 了 ,但 一 敲 代码 就 什么 都 忘 了 ? 
其 实 ,没有 人 天 生 就 会 写 代 码 , 之 所 以 会 有 这 种 遗忘 现象 的 发 生 , 说 到 底 是 练 得 太 少 了 ,总 觉 
得 书 上 的 例子 很 简单 ,而 不 愿意 动手 去 敲 一 遍 。 

. NET Core 作为 开源 项 目 , 可 能 会 有 许多 扩展 项 目 , 涉 及 内 容 较 广 , 由 于 篇 幅 与 作者 的 
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水 平 有 限 , 本 书 不 能 覆盖 所 有 的 应 用 领域 , 仅 精 选 出 与 . NET Core 主体 框架 关系 密切 且 较 
为 实用 的 实例 进行 演示 ,提供 给 大 家 作为 参考 。 

最 后 ,感谢 各 位 同仁 与 广大 网 友 对 我 的 支持 ,也 感谢 清华 大 学 出 版 社 , 我 们 已 经 合作 出 
版 过 多 种 图 书 。 


周 家 安 
2019 年 7 月 
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本 篇 内 容 侧 重 基础 知识 的 巩固 ,通过 学 习 各 章 的 实例 ,读者 能 够 党 
握 以 下 内 容 。 

。 搭建 与 配置 开发 环境 ; 

。 使 用 dotent 命令 行 工 具 或 者 Visual Studio 开发 环境 管理 应 用 

程序 项 目 ; 

。 代码 表达 式 与 流程 控制 ; 

。 日 期 ,数字 与 字符 串 的 处 理 技巧 ; 

。 理解 面向 对 象 编程 的 基本 思想 ; 

。 LINQ 语法 与 常见 集合 的 使 用 。 


搭建 开发 与 测试 环境 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 

。 Visual Studio 开发 环境 的 安装 ; 

。 .NET Core SDK 的 安装 ; 

。 在 Linux 操作 系统 中 搭建 测试 环境 。 


1.1 在 Windows 上 安装 开发 环境 


实例 1 安装 Visual Studio 


【导语 】 

由 于 Visual Studio 支持 的 跨 平 台 开 发 功能 越 来 越 完善 ,如 果 采 取 传 统 的 离线 包 安 装 方 
式 , 不 仅 占 用 硬盘 空间 大 ,也 不 便于 更 新 ,因此 笔者 推荐 在 线 安装 。 在 安装 Visual Studio 的 
时 候 , 读 者 可 以 根据 自己 的 需要 选择 安装 组 件 ,不 必要 完全 安装 。 

【操作 流程 】 

步骤 1: 打开 网 页 浏览 器 ,浏览 官方 主页 https: //www. visualstudio. comy/zh-hans , 然 
后 选择 适合 自己 的 Visual Studio 版 本 进行 下 载 , 如 图 1-1 所 示 。 

对 于 个 人 开发 者 或 者 小 型 开发 团队 来 说 ,可 以 优先 选用 Community 版 本 ,此 版 本 是 完 
全 免费 的 ,而 且 包 含 Visual Studio 的 完整 功能 。 

步骤 2: 下 载 的 文件 是 一 个 专门 的 安装 器 。 双 击 “ 运 行 ”, 会 启动 Visual Studio Installer 
组 件 。 如 果 是 首次 运行 ,或 者 查找 到 有 新 版 本 ,组 件 启动 时 会 有 一 个 初始 化 的 过 程 ,请 耐心 
等 待 初始 化 完成 。 

步骤 3: 安装 程序 初始 化 完成 后 ,会 提示 用 户 选择 要 安装 的 模块 ,此 时 在 “工作 负载 ? 标 
签 页 中 会 列 出 各 种 项 目 类 型 。 本 书 只 需要 安装 *. NET Core 跨 平台 开发 ”模块 ,如 果 读 者 需 
要 开发 其 他 类 型 的 应 用 项 目 , 可 以 按 需 选择 ,如 图 1-2 所 示 。 

窗口 右 方 的 “摘要 ”页 中 显示 即将 要 进行 安装 的 组 件 的 详细 列表 。“ 可 选 ”* 下 面 的 内 容 并 
非 必须 安装 ,用 户 可 以 自由 处 理 ,如 图 1-3 所 示 。 

步骤 4: 选 好 要 安装 的 组 件 后 , 单 击 窗口 右 下 方 的 “安装 ”按钮 开始 在 线 下 载 需要 的 安装 
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Visual Studio 下 载 


Visual Studio Visual Studio Visual Studio Visual Studio 
Community 2017 Professional 2017 Enterprise 2017 Code 
适用 于 学 生 、 开 源 和 个 人 适用 于 小 型 团队 的 专业 开 kb 重新 定义 了 Code 编辑 。 


开发 人 员 的 功能 完备 的 免 发 人 员工 具 、 服 务 和 订阅 的 要 免费 、 开 源 并 可 在 任何 位 
费 IDE 权益 置 运行 。 


发 行 说 明和 文档 > 发 行 说 明和 文档 > 发 行 说 明和 文档 > 
喇 [ 


下 载 Visual Studio 预览 版 二 b ual Studio 各 个 版 本 帮 如 何 离线 安装 此 


图 1-1 选择 合适 的 版 本 下 载 


工作 负载 单个 组 件 。 “语言 包 


使 用 JavaScript 的 移动 开发 站 使 用 C** 的 移动 开发 
使 用 用 于 Apache Cordova 的 工具 生成 Android、i0S 和 使 用 C** 对 i5、Android 或 Windows 生成 跨 平台 应 用 程 
UWP 应 用 。 序 。 


(全 使 用 C** 的 游戏 开发 
充分 使 用 C* * 生成 由 DirectX 、Unreal 或 Cocos2d 提供 技 
术 支持 的 专业 游戏 。 


其 他 工具 集 (3) 
品 Visual Studio 扩展 开发 A 使 用 C** 的 Linux 开 发 


是 为 Visual studio 创建 加 载 硕 和 扩展 ， 包 括 新 命令 、 代 码 分 析 人 律 和 也 式 在 Linux 环境 中 运行 的 应 用 程序 。 
器 和 工具 窗口 * 


四 NET Core 跨 平台 开发 
使 用 ,NET Core 、ASP.NET Core 、HTMUJavaScript 和 包括 
Docker 支持 的 容器 生成 啼 平 台 应 用 程序 * 


图 1-2 选择 要 安装 的 模块 


包 。 整 个 安装 过 程 都 是 自动 完成 的 ,具体 安装 时 间 取 决 于 用 户 前 面 所 做 的 选择 。 
步骤 5: 待 安装 顺利 完成 后 ,就 可 以 关闭 Visual Studio Installer 窗口 。 由 于 网 络 不 稳 
定 或 其 他 原因 导致 安装 过 程 没 有 顺利 完成 ,可 以 重新 运行 一 遍 安装 程序 ,直到 安装 完成 。 
步骤 6: 此 时 ,通过 Windows 系统 的 “开始 ”菜单 找到 Visual Studio < 版 本 号 > 图 标 , 就 
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摘要 
> Visual Studio 核心 编辑 器 
vv .NET Core 跨 平台 开发 
已 包含 
Y JNET Core 2.0 开发 工具 
YY ,NET Framework 4.6.1 开发 工具 
Y ASPJNET 和 Web 开发 工具 先决 条 件 
v Developer Analytics Tools 


可 选 
适用 于 Web 开发 的 云 工具 
IntelliTrace 
,NET 分 析 工 具 
Uve Unit Testing 
快照 调试 程序 
:NET Core 1.0 - 1.1 Web 版 开发 工具 


图 1-3 必 选 组 件 与 可 选 组 件 列表 
可 以 运行 Visual Studio 开发 环境 了 。 
注意 : 初次 运行 Visual Studio 的 时 候 , 开 发 环境 会 进行 初始 化 工作 。 然 后 需要 注册 一 个 


Microsoft 账号 进行 登录 ,以 获取 授权 许可 证 ,许可 证 的 获取 是 完全 免费 的 ,并 且 每 个 
月 会 自动 更 新 。 


实例 2 修复 Visual Studio 


【导语 】 
在 实际 开发 过 程 中 ,有 时 候 会 遇 到 Visual Studio 无 法 正常 使 用 的 情况 ,可 能 是 某 些 关 
键 性 数据 损坏 造成 的 ,也 可 能 是 安装 了 不 兼容 的 扩展 而 引起 的 。 此 时 ,可 以 通过 “修复 ”功能 
来 重新 安装 开发 环境 。 
【操作 流程 】 
步骤 1: 从 “开始 ”菜单 中 找到 Visual Studio Installer, 单 击 “ 运 行 ” 按 钮 。 
步骤 2: 在 已 安装 的 版 本 列表 中 , 单 击 “ 更 多 ...” 下 三 角 按钮 ,并 从 弹出 的 菜单 中 执行 “ 修 
复 ” 命 令 , 如 图 1-4 所 示 。 
EJ | Visual Studio Enterprise 2017 
Er 产 效 识 和 协调 性 需求 的 Microsoft 
DevOps 解决 方案 
发 行 说 明 
修改 启动 更 多 ~ 
修复 
扼 载 


图 1-4 选择 修复 操作 
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步骤 3: 此 时 安装 程序 会 重新 安装 Visual Studio ,请 耐心 等 待 安装 完成 。 

如 果 使 用 以 上 方法 仍 无 法 修复 ,可 以 执行 以 下 方案 。 

步骤 4: 以 管理 员 身 份 运行 “命令 行 提 示 符 ”窗口 (CCMD) ,然后 定位 到 Visual Studio 
Installer 的 安装 路 径 , 例 如 C: \Program Files (x86)\Microsoft Visual Studio\Installer\ 
resources\app\layout, 执 行 命令 InstallCleanup -i。 由 于 -i 参数 是 默认 选项 ,因此 可 以 直接 
执行 InstallCleanup。 

步骤 5: 正在 对 Visual Studio 安装 信息 进行 清理 。 

步骤 6: 安装 信息 清理 完成 后 ,InstallCleanup 程序 会 自动 退出 。 此 时 可 以 查看 Visual 
Studio 的 安装 目录 (例如 C: \Program Files (x86)\Microsoft Visual Studio\< 版 本 号 >) 是 
否 已 清空 ,如 果 里 面 还 有 内 容 , 请 手动 删除 。 

步骤 7: 再 次 运行 Visual Studio Installer, 重 新 安装 一 遍 。 

步骤 8: 此 时 ,Visual Studio 就 能 正常 运行 了 。 


1.2 在 Linux 操作 系统 中 配置 测试 环境 


实例 3 启用 Windows 上 的 Linux 子 系统 


【导语 】 

要 在 Linux 操作 系统 上 运行 和 测试 . NET Core 应 用 程序 ,用 户 不 需要 安装 双 操 作 系 
统 , 也 不 需要 搭建 虚拟 机 ,Windows 10 操作 系统 支持 Linux 子 系统 。Linux 子 系统 不 仅 可 
以 执行 大 多 数 Linux 命令 ,而 且 可 以 直接 访问 Windows 目录 和 文件 ,因为 它 已 经 集成 到 
Windows 操作 系统 的 功能 中 。 

使 用 Bash, 用 户 可 以 像 使 用 “命令 提示 符 ”(CMD) 程 序 一 样 与 Linux 子 系统 交互 。 目 
前 ,Windows 10 支持 五 个 Linux 发 行 版 ，Ubuntu、SUSE Linux 企业 服务 器 版 、 
OpenSUSE Kali Linux 和 Debian GNU / Linux。 

【操作 流程 】 

步骤 1: 打开 “控制 面板 ”, 找 到 “程序 与 功能 ”, 单 击 “ 启 用 或 关闭 Windows 功能 ”选项 。 

步骤 2: 在 功能 列表 中 勾 选 “适用 于 Linux 的 Windows 子 系统 " 复 选 框 ,如 图 1-5 所 示 。 

步骤 3: 单 击 “ 确 定 ” 按 钮 后 ,系统 会 进行 配置 ,配置 完成 后 需要 重新 启动 计算 机 。 这 一 
步 是 必需 的 ,否则 安装 Linux 子 系统 后 无 法 正常 启动 。 

步骤 4: 重新 启动 计算 机 后 ,在 Microsoft Store 中 搜索 关键 字 “Linux”, 在 建议 列表 中 
会 看 到 一 个 名 为 “在 Windows 上 运行 Linux” 的 应 用 集合 , 单 击 选取 。 此 时 会 列 出 前 面 所 提 
到 的 五 个 Linux 发 行 版 (如 图 1-6 所 示 ) ,读者 可 以 选择 自己 喜欢 的 版 本 下 载 。 

步骤 5: 此 处 以 Ubuntu 为 例 ,安装 完成 后 ,就 可 以 从 系统 的 应 用 列表 中 启动 它 了 。 

步骤 6: 首次 启动 时 ,会 提示 安装 初始 化 ,如 图 1-7 所 示 。 

步骤 7: 等 待 几 分 钟 ,初始 化 成 功 后 会 提示 输入 用 户 名 ,如 图 1-8 所 示 。 
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启用 或 关闭 Windows 功能 [2 


车 要 启用 一 种 功能 ， 请 选择 其 复 选 框 。 若 要 关闭 一 种 功能 ， 请 清除 其 复 选 
框 。 填 充 的 框 表示 仅 启用 该 功能 和 的 一 部 分 . 

回忆 xps 查看 导 ~ 
田 回国 打印 和 文件 服务 

回忆 工人 文件 去 客户 污 

闻 简单 TCPIP 服务 (0 echo、daytime 等 ) 
国 】 简单 网 络 管理 协议 (SNMP) 


口 晶 类 中心 桥接 | 
回 局 远 且 差分 压缩 APl 支持 


图 1-5 勾 选 Linux 子 系统 功能 


在 Windows 上 运行 Linux 


安装 Linux 发 行 版 并 在 适用 于 Linux 的 Windows 子 系统 (WSL) 上 并 排 运行 它 
们 。 


回 固 - 网 画 


Ubuntu openSUSE SUSE Linux Debian GNU/ Kali Linux 
女友 友 友 Leap 42 Enterprise... 太太 大 去 


冯 雪 交友 


图 1-6 支持 的 Linux 发 行 版 


注意 : 此 处 所 给 入 的 用 户 名 与 登录 计算 机 的 用 户 名 无 关 , 因 此 可 以 随意 输入 。 


步骤 8: 输入 用 户 名 后 , 按 下 Enter 键 确认 ,接着 输入 密码 ,如 图 1-9 所 示 。 
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1-7 Ubuntu 初始 化 


Ubuntu 


h your Windows username. 


图 1-8 输入 用 户 名 


图 1-9 输入 密码 


注意 : 此 处 输入 的 密码 与 登录 计算 机 时 的 密码 无 关 , 同 样 可 以 随意 输入 。 输 入 密码 需要 再 
次 确认 ( 即 输入 两 次 ) 。 在 输入 密码 的 过 程 中 ,屏幕 上 不 会 有 任何 显示 。 


步骤 9: 现在 Ubuntu 子 系统 可 以 正常 使 用 了 。 
实例 4 设置 root 密码 


【导语 】 

由 于 稍 后 需要 在 Linux 子 系统 中 安装 . NET SDK ,为 了 避免 在 安装 和 配置 过 程 中 因 权 
限 不 够 而 出 现 各 种 错误 ,本 例 将 演示 如 何 为 root 用 户 设 置 密码 ,以 便 在 安装 SDK 时 可 以 顺 
利 切 换 到 root 上 下 文 。 

【操作 流程 】 

步骤 1: 依然 以 Ubuntu 发 行 版 为 例 ,在 命令 窗口 中 输入 以 下 命令 并 确认 执行 。 


sudo passwd 


步骤 2: 输入 Ubuntu 初始 化 时 设置 的 密码 。 

步骤 3: 输入 为 root 用 户 设置 的 新 密码 (需要 再 次 确认 ) 。 

步骤 4: 输入 su 或 su root 命令 即 可 进入 root 上 下 文 。 

步骤 5: 如 果 想 返回 上 一 次 设置 的 用 户 上 下 文 , 可 以 输入 以 下 命令 。 
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su < 用 户 名 > 


注意 : 当 以 非 root 上 下 文 执行 命令 时 ,在 命令 前 面 加 上 sudo 可 以 允许 普通 用 户 获得 管理 员 
权限 ,这 样 可 以 执行 一 部 分 root 上 下 文才 能 执行 的 命令 (有 些 命令 仍然 需要 登录 root 
上 下 文才 能 执行 ) 。 
若 当 前 会 话 为 普通 用 户 , 会 在 计算 机 名 /用 户 名 后 面 显示 “ 串 ” 符 号 ; 若 当 前 会 话 为 
root, 会 在 计算 机 名 /用 户 名 后 面 显示 “ 井 ” 符 号 。 


实例 5 在 Linux 系统 中 安装 .NET Core SDK 


【导语 】 

尽管 . NET Core 应 用 程序 可 以 编译 为 “ 自 包含 可 执行 文件 ( 即 不 需要 在 目标 系统 中 安 
装 .NET Core SDK ,复制 程序 文件 即 可 直接 运行 ) ,但 是 “ 自 包含 模式 编译 后 输出 的 文件 体 
积 较 大 ,因为 其 中 包含 代码 执行 所 依赖 的 类 库 。 

如 果 目 标 机 器 上 只 运行 一 个 . NET Core 应 用 程序 ,那么 “ 自 包 含 ” 的 输出 模式 是 可 行 
的 ; 但 是 如 果 目 标 机 器 上 运行 多 个 .NET Core 应 用 程序 ,使 用 “ 自 包含 ”输出 模式 并 不 合适 ， 
因为 每 个 应 用 程序 运行 所 依赖 的 类 库 是 相同 的 , 即 存在 大 量 的 共用 文件 ,这 样 会 产生 许多 不 
必要 的 重复 文件 。 

举 个 例子 ,A 应 用 依赖 类 库 mscorlib. dll,B 应 用 也 依赖 类 库 mscorlib. dll ,并且 两 个 应 
用 所 依赖 的 类 库 版 本 相同 。 通 常 “ 自 包含 "模式 编译 后 会 把 依赖 的 类 库 文 件 放 到 应 用 程序 所 
在 的 目录 中 。 假 设 A 应 用 输出 到 FA 目录 下 ,B 应 用 输出 到 FB 目录 下 ,如果 同 时 将 A 应 用 
与 B 应 用 复制 到 同一 台 机 器 上 运行 ,此 时 就 会 产生 两 个 mscorlib. dll 文件 ,一 个 是 /FA/ 
mscorlib. dll, 另 一 个 是 /FB/mscorlib. dll, 两 个 完全 相同 的 文件 重复 存放 ,会 消耗 不 必要 的 
存储 空间 。 这 种 情况 下 ,应 该 考虑 直接 在 目标 机 器 上 安装 . NET Core SDK 或 . NET Core 
Runtime。 

本 实例 将 以 Ubuntu 为 例 来 进行 演示 。 如 果 出 于 开发 和 测试 用 途 ,建议 安装 . NET 
Core SDK 。 

【操作 流程 】 

步骤 1: 为 了 避免 权限 不 够 导致 安装 失败 ,请 输入 su 命令 切换 到 root 上 下 文 。 

步骤 2: 确定 Linux 版 本 与 发 行 代号 ,输入 命令 : 


cat /etc/]sb - release 


cat 命令 的 作用 是 显示 某 个 文件 中 的 内 容 ,/etc/1lsb-release 文件 中 存放 着 与 版 本 发 行 相关 的 
信息 。 此 时 会 得 到 如 图 1-10 所 示 的 输出 结果 。 

其 中 ,DISTRIB_RELEASE 是 版 本 号 ,DISTRIB_CODENAME 是 发 行 代 号 。 确 定 发 
行 版 本 是 为 了 方便 稍 后 添加 apt source。 
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图 1-10 查看 Linux 发 行 信息 


步骤 3: 导入 相关 密 钥 ,并 存储 在 本 地 文件 中 。 输 入 命令 : 

curl https://packages. microsoft. com/keys/microsoft. asc | gpg —— dearmor > /etc/apt/trusted. 

gpg. d/dotnet. gpg 
curl 命令 从 官方 提供 的 地 址 获取 ASCII 加 密 数据 ,然后 通过 gpg-dearmor 命令 将 密 钥 存储 
在 目录 /etc/apt/trusted. gpg. d 下 面 ,表明 该 密 钥 是 可 信任 的 。 

步骤 4: 为 了 能 够 获取 官方 提供 的 应 用 包 , 需 要 为 apt 添加 一 个 source 列表 。 命 令 
如 下 : 

echo "deb [arch = amd64] https://packages. microsoft. com/repos/microsoft - ubuntu - xenial 一 

prod xenial main" > /etc/apt/sources, list. d/dotnet. list 
请 确保 命令 中 源 地 址 上 的 Linux 发 行 代号 (如 本 例 中 的 xenial) 与 lsb-release 文件 中 显示 的 
发 行 代号 一 致 。 

步骤 5: 输入 以 下 命令 可 以 验证 dotnet. list 文件 是 否 成 功 写 人 。 

cat /etc/apt/sources. list. d/dotnet. list 


如 果 看 到 以 下 输出 ,说 明 dotnet. list 文件 已 成 功 写 入 。 


deb [arch = amd64] https://packages. microsoft. com/repos/microsoft — ubuntu — xenial — prod 
xenial main 


注意 : dotnet. list 只 是 本 例 中 使 用 的 文件 名 ,读者 可 以 根据 自己 偏好 设置 其 他 文件 名 。apt 
命令 在 更 新 sources 时 会 自动 扫描 sources. list. d 目录 下 面 的 文件 。 
步骤 6: 更 新 apt 源 , 以 获取 应 用 包 的 最 新 信息 。 
apt update 
步骤 7: 输入 以 下 命令 可 以 查看 哪些 版 本 的 包 可 用 。 
apt list | grep dotnet ~ sdk 


apt list 命令 列 出 当前 可 用 的 软件 包 名 称 , 然 后 将 输出 的 列表 传递 给 grep 命令 (通过 
“|” 字 符 ) ,并 使 用 正则 表达 式 进行 查找 。 该 命令 将 查找 名 字 中 包含 “dotnet-sdk” 的 软件 包 ， 
结果 如 图 1-11 所 示 。 

步骤 8: 输入 以 下 命令 ,安装 .NET Core SDK。 
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2. 0. 0/xenial 2.0.0-1 amd64 

2. 0. 0-preview2-006497/xenial 2. 0. 0-preview2-006497-1 amd64 
2. 0. 2/xenial 2.0.2-1 amd64 

2. 0. 3/xenial 2.0.3-1 amd64 

2. 1. 100/xenial 2. 0-1 amd64 
2. 1. 101/xenial 1-1 amd64 
re 

2 

2 1 

了 

2. 1 

Sl 


yy 
呈 呈 呈 己 


.10 

2.1.10 

. 1. 102/xenial 2. 1. 102-1 amd64 

. 1. 103/xenial 2. 1. 103-1 amd64 

. 1. 2/xenial 2. 1.2-1 amd64 

.1. 3/xenial 2. 1. 3-1 amd64 

. 1. 300-previewl-008174/xenial 2. 1. 300-preview1-008174-1 amd64 
4/xenial 2.1.4-1 amd64 


图 1-11 软件 包 查 找 结果 
apt install dotnet ~ sdk — 2.1.103 
其 中 ,2.1. 103 是 版 本 号 ,具体 可 以 参考 上 一 步 中 apt list 命令 所 列 出 的 有 效 版 本 号 。 
此 时 会 询问 用 户 是 否 继续 安装 , 若 要 安装 ,请 输入 y; 若 想 取消 安装 ,请 输入 n。 
步骤 9: 等 待 安装 完成 后 ,可 以 输入 以 下 命令 来 检查 是 否 安装 成 功 。 
dotnet ~ info 


如 果 看 到 相关 的 版 本 号 输出 ,说 明 安装 已 经 成 功 ; 如 果 出 现 错误 提示 ,请 重新 执行 以 上 


实例 6 在 Linux 系统 中 安装 .NET Core 运行 时 


【导语 】 

如 果 目 标 机 器 用 于 生产 运行 环境 ,可 以 考虑 不 安装 SDK 工具 ,而 仅 安装 运行 时 ,这 样 
.NET Core 应 用 程序 也 能 正常 运行 。 

本 实例 依旧 以 Ubuntu 为 例 进行 演示 。 

【操作 流程 】 

步骤 1: 执行 以 下 命令 可 以 查看 有 效 的 运行 时 版 本 。 


apt list | grep dotnet - runtime 一 * 


运行 结果 如 图 1-12 所 示 。 


dotnet-runtime-2. 0. 0/xenial 2.0.0-1 amd64 
dotnet-runtime-2. 0. 25407-01/xenial 2.0. 0-preyiew2-25407-01-1 amd64 
dotnet-runtime-2. 0. 3/xenial 2.0.3-1 amd64 
dotnet-runtime-2. 0. 4/xenial 2.0.4-1 amd64 


-2.0.5/xenial 2.0.5-1 amd64 
.0. 6/xenial 2.0.6-1 amd64 
. 1. 0-preyiew1-26216-03/xenial 2.1.0-previewl-26216-03-1 amd64 


dotnet-runtime 
dotnet-runtime 
dotnet-runtime 


otnet-runtime S-2. 1. 0-preview]-26216-03/xenial 2.1.0-previewl-26216-03-1 amd64 


图 1-12 有 效 的 运行 时 版 本 
步骤 2: 目前 最 新 版 本 为 2. 0. 6( 不 包括 预览 版 ) ,执行 以 下 命令 进行 安装 。 


apt install dotnet 一 runtime 一 2.0.6 
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步骤 3: 如 果 目 标 机 器 上 需要 运行 ASP. NET Core 应 用 程序 ,还 需要 安装 ASP. NET 
Core 运行 时 ,软件 包 名 称 为 aspnetcore-store< 版 本 号 >。 可 以 执行 以 下 命令 安装 。 
apt install aspnetcore— store 一 2.0.6 
2.0.6 是 目前 最 新 版 本 号 ,以 下 命令 可 以 查看 可 用 的 版 本 号 。 
apt list | grep aspnetcore— store— 关 


步骤 4: 安装 完成 后 ,运行 dotnet -info 命令 测试 ,如 果 安 装 成 功 ,会 输出 如 图 1-13 所 
示 的 内 容 。 


图 1-13 ”测试 安装 结果 


注意 : ASP. NET Core 运行 时 是 积累 更 新 的 ,新 版 本 与 旧版 本 之 间 可 能 存在 依赖 关系 ,因此 
安装 较 新 版 本 的 运行 时 ,会 同时 安装 旧版 本 的 运行 时 。 通 常 应 该 优先 考虑 安装 最 新 
版 本 的 运行 时 类 库 。 


应 用 程序 项 目 管理 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 

。 dotnet 命令 行 工 具 的 使 用 ; 

。 在 Visual Studio 开发 环境 中 管理 应 用 程序 项 目 ; 
。 发 布 应 用 程序 项 目 。 


2.1 .NET Core 命令 行 工 具 的 使 用 


实例 7 使 用 命令 行 工具 创建 . NET Core 项 目 

【导语 】 

.NET Core 命令 行 工 具 (CLID 名 称 为 dotnet, 它 可 以 直接 创建 、 修 改 、 编 译 和 发 布 . NET 
Core 应 用 程序 项 目 , 可 谓 是 “ 麻 淮 虽 小 ,五 脏 俱 全 ”。 

本 实例 将 演示 使 用 dotnet new 命令 创建 .NET Core 应 用 程序 项 目 。 

【操作 流程 】 

步骤 1: 按 快捷 键 Windows 十 E 打开 系统 的 文件 浏览 器 窗口 ,可 以 在 任意 位 置 新 建 一 
个 目录 ,目录 名 可 随意 设置 ,例如 test。 

步骤 2: 在 文件 浏览 器 窗口 的 地 址 栏 中 输入 
cmd, 按 下 Enter 键 会 打开 “命令 提示 符 ”" 窗 口 ,并 且 
工作 目录 会 自动 定位 到 当前 文件 夹 ,如 图 2-1 所 示 。 

步骤 3: 输入 dotnet new 命令 ,可 以 查看 相关 
帮助 信息 ,并 且 会 列 出 已 安装 的 项 目 模板 .如 图 2-2 图 2-1 打开 CMD 窗口 
所 示 。 

步骤 4: 输入 dotnet new console 命令 ,创建 一 个 控制 台 应 用 程序 项 目 。 

步骤 5: 项 目 创建 完成 后 ,打开 项 目 所 在 目录 ,可 以 看 到 CLI 工 具 生成 了 如 图 2-3 所 示 
的 文件 。 

其 中 ,test. csproj 为 项 目 文件 ,Program. cs 为 源 代 码 文件 ,默认 使 用 C# 编 程 语言 。 

步骤 6: 如 果 希 望 创建 使 用 VB. NET 编程 语言 的 控制 台 应 用 程序 项 目 , 可 以 加 上 -lang 


14 去 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


图 2-2 列 出 可 用 的 模板 


参数 ,并 指明 参数 值 为 vb, 即 输入 以 下 语句 。 


dotnet new console — lang vb 


生成 的 项 目 文件 如 图 2-4 所 示 。 


obj obj 
Program.cs Programvb 
回 testcsproj 国 testvbproj 
图 2-3 生成 的 项 目 文件 图 2-4 生成 VB.NET 代码 文件 


其 中 ,test. vbproj 是 项 目 文件 ,Program. vb 是 VB. NET 源 代 码 文件 。 


实例 8 定义 新 项 目的 名 称 与 存放 位 置 


【导语 】 


在 执行 dotnet new 命令 时 ,加 上 -n 或 -name 参数 可 以 为 新 项 目 指定 名 称 ( 若 未 指定 , 则 


使 用 当前 目录 的 名 字 
【操作 流程 


) ,还 可 以 通过 -o 或 -output 参数 指定 生成 的 项 目 文件 存放 的 目录 。 


步骤 1: 在 任意 位 置 新 建 一 个 目录 ,命名 为 MyDir。 可 以 使 用 以 下 命令 直接 创建 目录 。 


md MyDir 


步骤 2: 输入 以 下 命令 进入 MyDir 目录 。 


cd MYDir 


步骤 3: 输入 以 下 命令 ,在 MyDir 目录 下 创建 一 个 控制 台 应 用 程序 项 目 , 项 目 名 称 为 


App, 并 把 生成 的 文件 


F 放 到 Sample 子 目录 下 。 


dotnet new console —n App - o Sample 


步骤 4: 输入 以 下 命令 可 以 查看 生成 的 目录 与 文件 结构 ,如 图 2-5 所 示 。 
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tree /f 


2-5 ”生成 的 应 用 程序 项 目 文件 与 目录 结构 


实例 9 编译 应 用 程序 项 目 


【导语 】 
执行 dotnet build 命令 ,可 以 在 命令 行 下 编译 并 生成 应 用 程序 项 目 ,其 命令 格式 如 下 。 


dotnet build < 项 目 文件 名 > 
如 果 项 目 文件 名 被 忽略 , 则 默认 会 在 当前 目录 下 查找 可 用 的 项 目 文件 。 
【操作 流程 】 


步骤 1: 打开 “命令 提示 符 ” 窗 口 。 
步骤 2: 在 任意 位 置 新 建 一 个 目录 ,命名 为 MyApps。 


MD MyApps 

步骤 3: 进入 MyApps 目录 。 

cd MyApps 

步骤 4: 创建 一 个 控制 台 应 用 程序 项 目 。 
dotnet new console —n Appl 

步骤 5: 编译 应 用 程序 项 目 。 


dotnet build Appl\Appl. csproj 


注意 : 新 创建 的 项 目 被 放 在 名 为 Appl 的 子 目录 下 ,所 以 指定 项 目 文件 名 时 ,必须 是 相对 于 
当前 目录 的 路 径 。 用 户 也 可 以 先 执 行 cd Appl 进入 子 目 录 , 再 执行 dotnet build 命 
令 , 因 为 项 目 文件 就 在 Appl 目录 下 ,所 以 build 后 面 可 以 省 略 项 目 文件 名 。 


编译 后 的 程序 文件 如 图 2-6 所 示 。 
编译 后 的 程序 文件 位 于 bin\Debug\netcoreapp2.0 目录 下 ,其 中 Appl. dll 文件 是 项 目 
源 代码 编译 后 生成 的 二 进 制 文件 。 
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图 2-6 编译 后 的 程序 文件 


实例 10 ”编译 项 目的 Release 版 本 

【导语 】 

在 使 用 dotnet build 命令 进行 编译 时 ,附加 -c 或 -configuration 参数 可 以 指定 要 编译 的 
版 本 。 默 认 情况 下 使 用 Debug 版 本 (调试 版 本 ) ,如 果 希 望 生成 Release 版 本 (发 布 版 本 ), 则 
需要 明确 指定 -c 或 -configuration 参数 为 Release。 

【操作 流程 】 

步骤 1; 打开 * 命 令 提 示 符 "窗口 。 

步骤 2: 在 任意 位 置 新 建 一 个 目录 ,命名 为 Test。 

md Test 

步骤 3: 进入 Test 目录 。 

cd Test 

步骤 4: 创建 控制 台 应 用 程序 项 目 。 

dotnet new console 


步骤 5: 编译 项 目 ,生成 Release 版 本 。 


dotnet build - c Release 


步骤 6: 编译 后 ,输出 的 Test. dll 文件 就 是 
Release 版 本 ,如 图 2-7 所 示 。 


实例 11 创建 解决 方案 文件 


【导语 】 

解决 方案 通常 由 一 个 或 多 个 项 目 组 成 。 使 用 dotnet new sln 命令 可 以 创建 空白 的 解决 
方案 文件 ,之 后 再 向 解决 方案 文件 添加 或 删除 项 目 。 

【操作 流程 】 

步骤 1: 打开 “命令 提示 符 ” 窗 口 。 

步骤 2: 定位 到 任意 目录 ,并 在 其 中 新 建 一 个 目录 ,命名 为 Demos。 


2-7 ”生成 Release 版 本 


md Demos 


步骤 3: 进入 Demos 目录 。 


图 2-8 Demos 目录 的 结构 
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cd Demos 


步骤 4: 创建 一 个 解决 方案 文件 ,命名 为 Happy。 


dotnet new sln 一 n Happy 


步骤 5: 依次 执行 以 下 


dotnet new web 一 n demol 
dotnet new web 一 n demo2 


步骤 6: 执行 完 上 述 命 


当 如 图 2-8 所 示 。 


命令 ,创建 两 个 Web 项 目 ， 


分 别 命名 为 demol 和 demo2。 


今后 ,Demos 目录 的 结构 应 


步骤 7: 执行 以 下 命令 ,将 上 面 创建 的 demol 和 


demo2 项 目 添加 到 Happy 解决 方案 中 。 


dotnet sln Happy. sln add demol \ demol, csproj demo2\ 


demo2. csproj 


注意 : 由 于 当前 目录 下 只 有 一 个 Happy 解决 方案 ,因此 上 面 命令 中 可 以 省 略 Happy. sln 文 
件 名 , 即 dotnet sln add < 项 目 文件 列表 >。 


步骤 8: 此 时 用 文本 编辑 工具 打开 Happy. sln 文件 ,可 以 


看 到 对 上 面 添加 的 两 个 项 目的 描述 。 


Project ( " {FAE04ECO - 301F - 11D3 - BF4B — 00C04F79EFBC}") = 
"demol", "demol\demol. csproj", "{B65D34D6 - 05B7 — 428F — BAE8 


一 2C36C96DF341}" 
EndProject 


Project( " {FAE04ECO — 301F - 11D3 — BF4B — 00C04F79EFBC}") = 
"demo2", "demo2\demo2. csproj", "{0D373E8E — 7EEC — 45A4 — B024 


— 6E2E699C9516}" 
EndProject 


步骤 9: 用 Visual Studio 打开 Happy, 可 以 看 到 解决 方案 


与 两 个 Web 项 目的 关系 ,如 图 2-9 所 示 。 


实例 12 ” 枚 举 或 删除 解决 方案 中 的 项 目 


【导语 】 


网 解决 方 安 Happy' (2 个 项 目 ) 
4 加 demol 
市 Connected Services 
b ££ properties 


b ce Startup.cs 
4 贺 demo2 
市 Connected Services 
££ properties 
时 wwwroot 
. 依 各 项 
Ce program.cs 
cr Startup.cs 


图 2-9 在 Visual Studio 中 
查看 解决 方案 


向 解决 方案 文件 添加 项 目 后 ,可 以 使 用 dotnet sln list 命令 枚 举 该 解决 方案 所 包含 的 项 
目 。 之 后 如 果 不 再 需要 某 些 项 目 , 可 以 使 用 dotnet sln remove 命令 移 除 。 


【操作 流程 】 


步骤 1: 创建 一 个 空 的 解决 方案 文件 。 
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dotnet new sln 一 n MyApps 


步骤 2: 创建 四 个 项 目 , 其 中 一 个 是 控制 台 应 用 程序 项 目 ,另外 三 个 均 为 类 库 项 目 。 


dotnet new console 一 n MainApp 

dotnet new classlib 一 n ExtLibl 
dotnet new classlib 一 n ExtLib2 
dotnet new classlib 一 n ExtLib3 


步骤 3: 把 以 上 四 个 项 目 都 添加 到 解决 方案 中 。 


dotnet sln add MainApp\MainApp. csproj ExtLib1\ExtLibl. csproj ExtLib2\ExtLib2. csproj ExtLib3\ 
ExtLib3. csproj 


步骤 4: 输入 以 下 命令 可 以 查看 刚才 添加 到 解决 方案 中 的 项 目 列表 。 
dotnet sln list 


输出 结果 如 图 2-10 所 示 。 

步骤 5: 假设 用 户 不 需要 ExtLib2 和 ExtLib3 项 目 了 ,可 以 只 保留 ExtLibl 项 目 。 执 行 
以 下 命令 从 解决 方案 中 移 除 不 需要 的 项 目 。 

dotnet sln remove ExtLib2\ExtLib2. csproj ExtLib3\ExtLib3. csproj 

步骤 6: 执行 完 以 上 命令 后 ,可 以 重新 枚 举 一 下 解决 方案 中 的 项 目 列表 ,确认 指定 的 项 
目 是 否 被 移 除 。 


dotnet sln list 


通过 如 图 2-11 所 示 的 输出 结果 可 以 看 到 ,ExtLib2 和 ExtLib3 两 个 项 目 已 经 被 移 除 了 。 


nApF 
bl 
t 


图 2-10 解决 方案 中 的 项 目 列表 图 2-11 被 保留 的 项 目 列表 


注意 : 被 移 除 的 项 目 仅 从 解决 方案 文件 的 项 目 描 述 中 删除 ,而 与 项 目 相关 的 目录 与 文件 并 
不 会 删除 。 


实例 13 ”运行 应 用 程序 

【导语 】 

.NET Core 命令 行 工具 运行 应 用 程序 比较 简单 ,输入 dotnet 二 . dl 文件 名 之 即 可 。 黑 
认 情 况 下 ,编译 . NET Core 应 用 程序 后 会 生成 依赖 于 框架 的 版 本 , 即 目标 平台 需要 安装 
.NET Core 运行 时 类 库 后 才能 正常 运行 ,这 样 可 以 大 大 节省 存储 空间 。 因 此 编译 后 仅仅 输 
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出 一 个 扩展 名 为 . dll 的 文件 ,将 生成 的 . dll 文件 提供 给 dotnet 命令 ,运行 框架 会 自动 加 载 并 
寻找 程序 人 口 点 ,找到 入 口 点 后 应 用 程序 就 会 开始 执行 ,直到 退出 。 

【操作 流程 】 

步骤 1: 在 任意 目录 下 ,新 建 一 个 名 为 Demo 的 子 目 录 。 


md Demo 

步骤 2: 进入 Demo 目录。 

cd Demo 

步骤 3: 新 建 一 个 控制 台 应 用 程序 项 目 。 
dotnet new console 

步骤 4: 编译 并 生成 应 用 程序 项 目 。 
dotnet build 

步骤 $: 进入 生成 文件 所 在 的 目录 (默认 在 bin\Debug 子 目录 下 )。 
cd bin\Debug\netcoreapp2.0 

步骤 6: 运行 应 用 程序 。 

dotnet Denmo. dll 


步骤 7: 若 看 到 控制 台 窗口 输出 “Hello World!”, 表 示 应 用 程序 已 经 正常 运行 了 。 


注意 : 最 好 对 . dll 文件 名 严格 区 分 大 小 写 , Windows 平台 可 以 忽略 大 小 写 , 但 是 Linux 平台 
是 必须 严格 区 分 大 小 写 的 。 如 本 例 中 的 文件 名 为 Demo. dll, 如 果 在 Linux 系统 上 使 
用 demo. dll, 是 找 不 到 目标 文件 的 。 


2.2 Visual Studio 开发 环境 


实例 14 使 用 Visual Studio 创建 项 目 


【导语 】 

Visual Studio 集成 开发 环境 提供 了 从 开发 到 调试 ,再 到 发 布 的 一 整套 工具 ,可 以 更 高 
效 地 管理 应 用 程序 项 目 。 借 助 该 开发 环境 的 许多 优秀 功能 ,编写 代码 变 得 更 简单 。 

本 例 将 演示 如 何在 Visual Studio 开发 环境 中 新 建 . NET Core 应 用 程序 项 目 。 

【操作 流程 】 

步骤 1: 从 窗口 顶部 的 菜单 栏 中 执行 "文件 新建" 一 项目” 命令 ,也 可 以 按 快捷 键 
Ctrl+Shift 十 N, 或 者 单 击 工具 栏 上 的 国 按 钮 。 
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步骤 2: 此 时 会 打开 “新 建 项 目 ” 对 话 框 ,如 图 2-12 所 示 。 


图 2-12 “新 建 项 目 ” 对 话 框 


步骤 3: 在 对 话 框 左边 的 模板 分 类 中 选择 “Visual C#”>*. NET Core”。 

步骤 4: 对 话 框 中 间 区 域 会 列 出 相应 的 项 目 模板 。 

步骤 5: 选择 “控制 台 应 用 ”, 然 后 在 对 话 框 下 方 的 输入 框 中 输入 项 目 和 解决 方案 的 名 
称 ,以 及 所 存放 的 路 径 。 


注意 : 当 输 入 项 目 名 称 时 ,解决 方案 的 名 称 会 同步 改变 , 即 默 认 情 况 下 ,解决 方案 的 名 称 与 
项 目 名 称 相 同 。 如 果 不 希 望 两 者 的 名 称 相同 ,需要 单独 修改 解决 方案 的 名 称 。 


步骤 6: 输入 完 各 个 参数 后 , 单 击 右 下 角 的 “确定 ”按钮 ,开发 工具 开始 创建 项 目 。 等 待 
项 目 创建 完成 后 ,会 自动 打开 模板 生成 的 Program. cs 文件 。 


注意 : 扩展 名 .cs 是 C# 代 码 文件 专用 后 组 , 即 C Sharp 的 缩写 。 


步骤 7: 此 时 会 看 到 如 代码 清单 2-1 所 示 的 程序 代码 。 
代码 清单 2-1 Program. cs 


using System; 


namespace MyApp 
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class Program 
{ 
static void Main( string[ ] args) 
{ 
Console. WriteLine( "Hello World! "); 
} 


} 

步骤 8: 至 此 ,. NET Core 应 用 程序 项 目 在 Visual Studio 中 创建 完毕 。 

实例 15 在 Visual Studio 中 运行 项 目 

【导语 】 

在 上 一 个 实例 中 已 经 创建 了 一 个 控制 台 应 用 程序 项 目 , 本 实例 将 引导 读者 运行 应 用 

【操作 流程 

步骤 1: 对 Program. cs 文件 中 的 代码 进行 修改 ,把 “Hello World!1” 改 为 “这 是 我 的 第 一 
个 应 用 程序 ,”, 然 后 按 快捷 键 Ctrl 十 S 保存 ,或 单 击 工具 栏 上 的 园 按 钮 保存 。 修 改 后 的 代 
码 如 代码 清单 2-2 所 示 。 

代码 清单 2-2 ”修改 后 的 Program. cs 文件 


using Systenm; 


namespace MyApp 
{ 


class Program 
{ 
static void Main( string[ ] args) 
{ 
Console. WriteLine(" 这 是 我 的 第 一 个 应 用 程序 ."); 
} 


: 


步骤 2: 从 菜单 栏 中 执行 “调试 ”开始 调试 ”或 者 按 F5 键 ,应 用 程序 就 会 以 调试 模 
式 运 行 。 

步骤 3: 此 时 控制 台 窗 口 一 启动 就 退出 了 。 那 是 因为 应 用 程序 已 经 执行 完了 ,如 果 想 看 
到 窗口 上 输出 的 文件 ,可 以 在 Main 方法 的 最 后 ( 右 大 括号 之 前 ) 加 上 一 行 Console. Read 方 
法 的 调用 ,这 样 应 用 程序 执行 到 这 里 会 停 下 来 ,以 等 待 用 户 的 输入 ,如 代码 清单 2-3 所 示 。 
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代码 清单 2-3 ”在 Main 方法 中 添加 的 代码 


static void Main(string[ ] args) 

{ 
Console. WriteLine(" 这 是 我 的 第 一 个 应 用 程序 。"); 
Console. Read( ); 


步骤 4: 再 次 运行 应 用 程序 ,就 能 看 到 如 图 2-13 所 示 的 输出 了 。 


图 2-13 应 用 执行 时 的 输出 
步骤 5: 在 系统 的 “任务 管理 器 ”窗口 可 以 查看 dotnet 进程 ,如 图 2-14 所 示 。 
FRR 


文件 (月 ”选项 (0) 查看 (V) 
进程 ”性 能 应 用 历史 记录 启动 用户 详细 信息 服务 


名 浆 命令 行 ~ 
中 ChsIME.exe CAWindows\System32\InputMethod\CHS\ChsIME.exe -Embedding ] 
国 conhostexe \ANCAWINDOWS\system32\conhost.exe Ox4 
国 conhostexe \INCAWINDOWS\system32\conhost.exe 0x4 | 
画 conhostexe NCAWINDOWS\system32\conhost.exe Ox4 上 上 
国 conhostexe \INCAWINDOWS\system32\conhost.exe Ox4 
国 cerssexe 
国 csrssexe 
四 cfmonexe “ctfmon.exe” 

国 dasHostexe dashost.exe (e2f460cb-Oaac-44bb-87ac8a695985e1a7] 

国 DataExchangeHost-。 CAWindows\System32\DataExchangeHost.exe -Embedding 

Ddevenv.exe “CAProgram Files (x86)\Microsoft Visual Studio\2017\Enterprise\CommonT\IDE\devenv.exe” 

国 dlhostexe C\WINDOWS\system32\DllHost.exe /Processid973D20D7-562D-4489-870B-5AOF49CCDF3P) 

国 dlhostexe CAWINDOWS\system32\DllHost.exe /Processid:AB8902B4-09CA-4BB6-B78D-ABF59079A8D5) 

国 dwmexe “dwm.exe” 

explorer.exe CAWINDOWS\Explorer EXE 

国 fontdrvhostexe “fontdrvhostexe” 

afontdvhostexe “fontdvhostexe” 

国 IpoverUsbsvcexe “CAProgram Files (x86)\Common Files\Microsoft Shared\Phone Tools\CoreCon\11.0\bin\lpOverUsbSvc.exe” 

国 kassexe CNWINDOWSVeystem3azysassexe 

国 Microsoftphotose-。 "CNprogram Files\WindowsApps\Microsoft Windows.Photos_2018.18022.15810.1000 x64_Bwekyb3d8bbwe\Microsoft photos.exe... 

困 MsAscuiLexe "CNProgram Files\Windows DefenderMSASCuiLexe” 

羡 MsBuild.exe CAProgram Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe /nologo /nodemode:1 /nodeReus.. v 

> 
| 结束 任务 但 


图 2-14 ”dotnet 命令 行 工具 出 现在 进程 列表 中 
并 且 ,dotnet 进程 中 附加 的 命令 行 参 数 如 下 : 
"<.NET Core 运行 时 路 径 >\dotnet. exe" exec "< 应 用 程序 项 目 路 径 >\< 应 用 程序 名 称 >. dll" 
这 表明 Visual Studio 在 运行 应 用 程序 时 是 执行 了 dotnet 命令 的 。 
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步骤 6: 如 果 在 执行 应 用 程序 时 不 希望 加 载 调试 信息 ,可 以 执行 “调试 ”开始 执行 (不 
调试 ) ”命令 ,或 者 使 用 快捷 键 Ctrl 十 F5。 


实例 16 显示 代码 行 号 

【导语 】 

行 号 就 是 为 每 一 行 代码 进行 编号 。 在 代码 编辑 器 中 显示 代码 的 行 号 ,可 以 快速 定位 代 
码 的 位 置 。 

【操作 流程 】 

步骤 1: 执行 “工具 ”>“ 选 项 ”命令 ,打开 “选项 ”对 话 框 。 

步骤 2: 在 左边 菜单 中 找到 “文本 编辑 器 ”菜单 项 ,然后 选择 一 种 编程 语言 ,如 图 2-15 
所 示 。 


4 文本 篇 名 器 
雪夫 启用 虚空 居 (V) 
文件 扩展 名 回 自动 二 行 W) 
Basic 本 团 旺 示 可 视 的 自动 放行 标志 符号 (S$) 
b CoffeeScript BsY 到 
b Css 回 启 用 单 击 URL 定位 (U) 
pr 器 SEN) 
Re 回 自 动 补 全 大 括 S(B) 
b HTML(Web 窗 体 ) 
a 团 没 有 渤 证 内 容 时 对 空 行 应 用 苋 切 或 复制 命令 (C) 


图 2-15 定位 文本 编辑 器 选项 


步骤 3: 在 对 话 框 右边 的 选项 卡 中 , 勾 选 “ 行 号 " 复 选 框 ,然后 单 击 对 话 框 右 下 方 的 确定 
按钮 即 可 保存 。 

步骤 4: 如 果 需 要 所 有 编程 语言 的 代码 都 显示 行 号 ,可 以 在 “文本 编辑 器 ”命令 中 选择 
“所 有 语言 ", 再 勾 选 “ 行 号 " 复 选 框 即 可 ,如 图 2-16 所 示 。 


SQL Server Tools 设置 
b T-SQL90 pe 
b XAML 加 自动 疙 行 W) 
DME 加 明示 可 视 的 自动 缠 行 标志 符号 (S) 
b 纯 文本 总 
上 所 有 末 计 后 
调 坛 国 启用 单 去 URL 定位 ( 山 


图 2-16 让 所 有 代码 显示 行 号 


步骤 5: 关闭 对 话 框 时 ,记得 单 击 “ 确 定 ” 按 钮 保存 设置 。 
步骤 6: 现在 代码 编辑 器 的 左 侧 就 会 显示 代码 行 号 了 ,如 图 2-17 所 示 。 


24 十 .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


2-17 ”代码 行 号 


注意 : 无 论 是 编译 错误 ,还 是 调试 信息 ,Visual Studio 都 能 够 智能 地 定位 代码 位 置 ,因此 可 
以 隐藏 代码 行 号 。 但 显示 代码 行 号 对 于 开发 者 之 间 的 交流 是 有 好 处 的 ,例如 对 于 一 
份 由 团队 协作 编写 的 代码 ,在 讨论 代码 时 ,A 可 以 跟 忆 说 :“ 第 26 行 代码 那里 似乎 逻 
辑 不 对 ,请 你 再 测试 一 下 。”,B 在 自己 的 机 器 上 打开 代码 文件 ,通过 行 号 可 以 快速 找 
到 第 26 行 代码 。 
对 于 有 一 定 规模 的 开发 团队 ,可 考虑 使 用 Visual Studio 的 团队 服务 来 进行 代码 审核 评定 。 


实例 17 在 C# Interactive 窗口 中 做 代码 实验 


【导语 】 

C# Interactive(C 井 交互 ) 是 Visual Studio 的 子 窗口 ,可 以 在 窗口 中 直接 编写 代码 ,无 
须 新 建 项 目 。 此 功能 非常 适用 于 编写 简单 的 程序 代码 , 即 可 用 于 做 代码 实验 。 例 如 需要 测 
试 一 个 Environment 类 的 MachineName 属性 会 返回 什么 内 容 , 这 种 情况 下 没有 必要 刻意 新 
建 一 个 项 目 做 测试 ,可 以 在 C# Interactive 窗口 中 直接 编写 代码 来 实验 。 

【操作 流程 】 

步骤 1: 在 开发 环境 窗口 的 菜单 栏 中 执行 “视图 ”>“ 其 他 窗口 >“C# 交互 ”命令 ,打开 
C# Interactive 窗口 ,如 图 2-18 所 示 。 


图 2-18 C# Interactive 初始 化 
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步骤 2: 以 列举 所 有 受 支 持 的 区 域 与 语言 信息 为 例 。 输 入 一 行 using 指令 ,然后 按 下 
Enter 键 确定 ,引入 需要 的 命名 空间 ,输入 代码 如 下 。 


> using System. Globalization; 
注意 : 代码 前 面 的 “二 ”是 交互 脚本 在 代码 的 行 首 自动 生成 的 字符 ,不 属于 代码 部 分 。 


步骤 3: 输入 以 下 代码 ,获取 并 输出 各 个 区 域 /语言 的 标识 、 显 示 名 称 及 LCID 值 。 


> using System. Global ization; 
> var cultures = CultureInfo.GetCultures(CultureTypes. AllCultures); 


> foreach(var c in cultures) { 
，Console, WriteLine( $ "{c. Name, ~ 20}{c. LCID, - 10}{c. DisplayName, — 30}"); 


.} 

在 上 面 代 码 中 ,首先 调用 GetCultures 静态 方法 返回 一 个 CultureInfo 类 型 的 数组 , 然 
后 使 用 foreach 语句 访问 数组 中 的 每 个 CultureInfo 对 象 ,分 别 通 过 Name、 DisplayName、 
LCID 三 个 属性 获取 所 需 信息 。 

步骤 4: 输入 完 代码 后 , 按 下 Enter 键 ,代码 脚本 会 进行 编译 并 且 执 行 ,最 后 会 在 C# 
Interactive 窗口 中 输出 如 图 2-19 所 示 的 内 容 。 


4096 
yav-CM 
yi 


yi-001 


Tfng 
Tfng-MA 


别 行政 区 ) 
门 特别 行政 区 ) 


(繁体 ， 中 国 香港 特别 行政 区 ) 
( 繁 中 国 澳门 特别 行政 区 ) 


图 2-19 输出 区 域 /语言 信息 
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注意 ; 在 C# Interactive 窗口 中 ,输入 井 clear 或 井 cls, 可 以 清空 窗口 中 的 显示 内 容 , 输 入 
井 reset 可 以 重 置 脚本 , 即 重新 初始 化 。 
一 旦 按 下 Enter 键 提交 后 ,代码 就 无 法 修改 了 ,如 果 输 错 了 ,只 能 重新 输入 。 


实例 18 在 解决 方案 中 添加 和 移 除 项 目 


【导语 】 

一 个 解决 方案 可 以 包含 一 个 或 多 个 项 目 ,在 创建 项 目 时 会 默认 创建 一 个 解决 方案 ,并 且 
将 该 项 目 添 加 到 解决 方案 中 。 在 Visual Studio 的 “解决 方案 资源 管理 器 "窗口 中 ,用 户 可 以 
很 轻松 地 添加 或 移 除 应 用 程序 项 目 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 项 目 , 项 目 名 称 为 Demol ,解决 方案 名 称 为 MySub ,如 图 2-20 
所 示 。 

步骤 2: 打开 “解决 方案 资源 管理 器 ”窗口 ,在 解决 方案 名 称 上 右 击 , 从 菜单 中 执行 “ 添 
加 ”> 新建 项 目 .…” 命 令 ,选择 . NET Core 模板 中 的 类 库 项 目 , 命 名 为 Demo2。 添 加 新 项 目 
后 ,“ 解 决 方案 资源 管理 器 "窗口 中 的 结构 如 图 2-21 所 示 。 


排序 次 据 : 默认 值 


NET Standard 
Cloud 
Web 
测试 
未 找到 你 要 坦 找 | 


名 称 (N) 


位 置 (| 


解决 方 室 名 称 (M): [AS 
图 2-20 新 建 第 一 个 项 目 图 2-21 此 时 解决 方案 中 有 两 个 项 目 


步骤 3: 如 果 需 要 移 除 Demo2 项 目 , 可 以 在 项 目 名 称 上 右 击 ,从 菜单 中 执行 “删除 ”命令 


即 可 。 
实例 19 添加 NuGet 包 引 用 
【导语 】 


NuGet 包 是 专 为 .NET 开发 者 建立 的 开源 项 目 平台 , 它 已 成 为 Visual Studio 的 一 个 工 


具 , 能 够 简便 轻松 地 在 项 目 中 添加 各 种 组 件 。 

以 添加 PdfSharpCore 组 件 为 例 , 演 示 如 何在 项 目 中 引用 NuGet 包 。 

【操作 流程 】 

步骤 1: 参考 实例 18 ,在 Visual Studio 中 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 打开 “解决 方案 资源 管理 器 "窗口 ,在 “依赖 项 结 点 上 右 击 ,从 菜单 中 选择 “管理 
NuGet 程序 包 ”, 如 图 2-22 所 示 。 


图 2-22 “管理 NuGet 程序 包 ” 菜 单 


步骤 3: 在 搜索 框 中 输入 “PdfSharpCore”, 选 中 查找 结果 中 的 PdfSharpCore 组 件 ,在 窗 
口 右 侧 窗 格 中 单 击 “ 安 装 "按钮 (如 图 2-23 所 示 ) ,Visual Studio 会 自动 引用 组 件 。 


网 PdfsharpCore 
PdfSharpCore EH Stefen Steiger and Contributors, 224K 个 下 载 。v1.01 
pdfsharp for .NET Core 
版 本 : 蜡 新 稳定 类 1.0.1 
HtmlRendererCore.PdfSharpCore 由 Nichole 
Dotnetcore Htmlto PDF Ge 
搞 述 
pdfsharp for NET Core 


图 2-23 安装 NuGet 包 
步骤 4: 此 时 ,在 “依赖 项 ”>NuGet 结 点 下 可 以 看 到 PdfSharpCore 组 件 ,如 图 2-24 所 示 。 


图 2-24 PdfSharpCore 已 添加 到 项 目 中 
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若 要 删除 已 引用 的 NuGet 包 , 先 将 其 选中 ,然后 按 下 Del 键 或 从 快捷 菜单 中 执行 “ 移 
除 ” 命 令 。 


实例 20 清除 NuGet 包 缓 存 


【导语 】 

下 载 NuGet 包 时 ,程序 包 会 存储 在 本 地 计算 机 ,因此 会 产生 缓存 文件 。 如 果 安 装 的 
NuGet 程序 包 比 较 多 ,缓存 占用 的 磁盘 空间 自然 会 增加 , 当 磁 盘 空 间 紧 张 (或 有 些 程序 包 不 
再 使 用 ) 的 情况 下 ,可 以 考虑 清理 缓存 。 

NuGet 程序 包 的 缓存 目录 一 般 位 于 C: \Users\< 用 户 名 >\. nuget\packages, 除 了 进入 
此 目录 手动 删除 程序 包 外 ,Visual Studio 本 身 也 提供 了 清理 缓存 的 功能 ,具体 操作 如 下 。 

【操作 流程 】 

步骤 1: 在 Visual Studio 开发 环境 中 ,从 菜单 栏 中 依次 执行 “工具 ”>“ 选 项 "命令 ,打开 
“选项 ”对 话 框 。 

步骤 2: 从 左边 的 导航 窗 格 中 选择 “NuGet 包 管理 器 ” ,右边 的 内 容 页 中 会 看 到 一 个 “ 清 
除 所 有 NuGet 缓存 ”按钮 , 单 击 它 就 可 以 清除 NuGet 程序 包 缓 存 了 ,如 图 2-25 所 示 。 


搜索 选项 (Ctrl+ 日 


| 


”性 能 工具 在 Visual Studio 中 生成 期 间 自动 检查 缺少 的 程序 包 (M) 
上 Azure 服务 身份 验证 绑 定 重 定向 


上 NuGet 包 管理 器 口 顺 过 应 用 和 绑 定 重 定向 (B) 


图 2-25 清除 NuGet 包 缓 存 


实例 21 保存 窗口 布局 


【导语 】 

Visual Studio 支持 保存 子 窗口 的 布局 ,在 需要 的 时 候 可 以 迅速 套用 。 此 功能 适用 于 特 
定 偏好 的 开发 者 。 例 如 ,在 开发 Web 应 用 程序 项 目 时 可 以 使 用 自己 感觉 最 “顺手 ”的 窗口 布 
局 方案 ; 在 开发 其 他 类 型 的 应 用 程序 项 目 时 ,可 以 快速 切换 到 另 一 个 布局 。 

本 实例 将 演示 如 何 保存 窗口 布局 ,并 在 两 个 布局 方案 中 进行 切换 。 
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【操作 流程 】 

步骤 1: 启动 Visual Studio 开发 环境 。 

步骤 2: 通过 “视图 ”菜单 的 子 菜单 ,分 别 打 开 “ 解 决 方案 资源 管理 器 “类 视图 “输出 ”三 
个 窗口 。 

步骤 3: 把 “类 视图 ”窗口 放 在 左 侧 ,“ 解 决 方案 资源 管理 器 ”窗口 放 在 右 侧 ,并 把 “输出 ” 
窗口 放 在 主 窗口 的 底部 ,如 图 2-26 所 示 。 


图 2-26 三 个 子 窗口 的 位 置 


步骤 4: 在 菜单 栏 中 执行 “窗口 >“ 保存 窗口 布局 "命令 ,会 弹出 一 个 要 求 输入 布局 方案 
的 名 称 的 对 话 框 ,输入 “布局 方案 1”, 并 单 击 “ 确 定 ” 按 钮 ,如 图 2-27 所 示 。 

步骤 5: 依照 步骤 2 的 方法 ,通过 “视图 ”菜单 分 别 打 开 “ 属 性 ”窗口 和 “工具 箱 ” 窗 口 。 并 
将 “属性 ”窗口 放 在 主 窗口 左 侧 ,“ 工 具 箱 ”窗口 放 在 主 窗口 右 侧 ,布局 如 图 2-28 所 示 。 

步骤 6: 也 将 此 布局 保存 ,命名 为 “布局 方案 2”。 

步骤 7: 此 时 在 “窗口 ”~* 应 用 窗口 布局 ”的 子 菜单 下 ,就 能 看 到 刚刚 保存 的 两 个 布局 方 
案 了 。 单 击 其 中 一 个 就 可 以 进行 布局 切换 。 

步骤 8: 执行 “窗口 >“ 管理 窗口 布局 ”命令 ,打开 “管理 窗口 布局 ”对 话 框 ,如 图 2-29 
所 示 。 

步骤 9: 在 该 对 话 框 中 ,用 户 可 以 对 布局 方案 重 命名 、 重 新 排序 和 删除 。 
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祖 定 (0) 职 测 (C) 


图 2-27 输入 布局 方案 名 称 


图 2-28 “属性 ”窗口 与 “工具 箱 ” 窗 口 的 布局 
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EE EE] 
图 2-29 “管理 窗口 布局 ”窗口 


实例 22 给 代码 打 书签 

【导语 】 

在 某 行 代码 上 打上 书签 ,在 阅读 代码 时 可 以 快速 定位 ,其 用 途 与 现实 世界 中 的 书签 是 相同 的 。 

【操作 流程 】 

步骤 1: 打开 任意 代码 文档 。 

步骤 2: 在 代码 文档 中 找到 要 添加 书签 的 代码 行 ,并 在 该 行 中 任意 位 置 单 击 ,此 时 ,该 行 
周围 会 出 现 一 个 矩形 框 ,如 图 2-30 所 示 。 


图 2-30 确定 代码 行 


步骤 3: 执行 菜单 “编辑 ”一 “书签 ”>“ 切 换 书签 命令。 书签 添加 成 功 后 ,会 在 代码 编辑 
器 左 侧 显示 辐 图 标 。 

步骤 4: 再 次 执行 “切换 书签 "命令 ,可 以 取消 该 行 的 书签 。 

步骤 5: 当 书 签 数 量 较 多 时 ,还 可 以 执行 “视图 ”>“ 其 他 窗口 >“ 书签 窗口 "命令 ,打开 
“书签 ”窗口 。 在 “书签 ”窗口 中 ,可 以 对 所 有 书签 进行 统一 管理 ,还 可 以 重 命 名 书签 ,如 
图 2-31 所 示 。 


2-31 “书签 "窗口 
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2.3 代码 注释 


实例 23 单行 注释 

【导语 】 

单行 注释 只 对 当前 行 有 效 , 而 且 只 能 写 一 行 注释 (自动 换行 除外 )。 注 释 以 *//" 开 头 ， 
“//? 之 后 的 内 容 皆 被 视 为 注释 。 

代码 注释 不 参加 编译 ,主要 用 途 是 说 明代 码 的 功能 或 调用 时 要 注意 的 事项 ,方便 人 们 阅 
读 和 理解 代码 。 在 编程 过 程 中 应 当 养 成 写 注释 的 好 习惯 , 既 方 便 他 人 ,也 方便 自己 。 

【操作 流程 】 

下 面 注释 为 三 行 ,由 于 “//” 只 能 注释 一 行 ,所 以 每 一 行 开头 都 要 写 上 “//”。 

// 第 一 行 注释 

// 序 列 化 一 个 对 象 

// 可 以 选用 xML 或 JSON 格式 

但 是 以 上 写法 并 不 完美 ,“//” 与 后 面 的 内 容 距 离 太 近 , 不 便于 阅读 。 可 以 考虑 在 “//” 之 
后 加 入 空格 ,例如 下 面 这 样 读 起 来 会 更 舒适 。 

// 第 一 行 注释 

// 序列 化 一 个 对 象 

// 可 以 选用 XML 或 JSON 格式 


实例 24 多 行 注释 


【导语 】 

多 行 注释 可 以 将 一 行 或 多 行 标记 为 注释 ,格式 是 以 "/* ?开始 ,以 "* /” 结 尾 。“/ * ”与 
“x /” 在 代码 文档 中 必须 成 对 出 现 。 

【操作 流程 】 

以 下 注释 为 多 行 注释 ,在 注释 块 的 起 始 加 上 “/ x*”, 在 注释 块 的 结尾 加 上 “ x* /”。 


作者 :Mr Lu 
修订 日 期 :3 月 5 日 
修订 版 本 号 :v1.1 
开发 组 :A 组 


实例 25 文档 注释 
【导语 】 
文档 注释 是 针对 代码 文档 结构 而 设 定 的 , 它 可 以 将 类 型 或 类 型 成 员 的 详细 说 明文 本 提供 
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给 调用 代码 的 开发 者 ,并 且 文 档 注释 也 会 显示 在 Visual Studio 代码 编辑 器 的 智能 提示 中 。 
文档 注释 通常 以 “///” 开 头 , 而 且 会 使 用 特定 的 XML 元 素 。 常 见 的 文档 注释 元 素 如 下 : 
(1) < summary >: 摘要 。 概 括 性 的 描述 ,一 般 用 于 类 型 和 类 型 成 员 ( 如 属性 、 事 件 、 方 
法 等 )。 
(2) < param >: 用 来 描述 方法 参数 ,需要 指定 name 值 ,使 注释 内 容 与 对 应 的 参数 关联 。 
(3) < returns >: 用 来 描述 方法 的 返回 值 。 
(4) < see>: 可 以 从 当前 注释 中 链接 到 其 他 类 型 。 
(5) < remarks >: 备注 信息 ,可 作为 < summary > 的 补充 。 
【操作 流程 】 
步骤 1: 声明 一 个 Person 类 ,其 中 包含 两 个 属性 。 


public abstract class Person 

{ 
public string Name { get; set; } 
public int Age { get; set; } 

. 


步骤 2: 分 别 为 Person 类 以 及 它 的 成 员 写 文档 注释 。 


/// < summary> 
/// 该 类 表示 某 个 人 的 基本 信息 
/// </summary> 
/// < remarks > 它 是 一 个 抽象 类 ,不 能 直接 实例 化 </remarks > 
public abstract class Person 
{ 
/// < summary> 
/// 姓名 
/// </summary> 
public string Name { get; set; } 


/// < summary> 
/// 年 龄 。 该 属性 的 值 为 < see cref = "System. Int32" 人 > 类 型 
/// </summary> 
public int Mge { get; set; } 
} 


步骤 3: 当 在 代码 中 使 用 Person 类 时 ,文档 注释 会 出 现在 智能 提示 中 ,如 图 2-32 所 示 。 


图 2-32 智能 提示 中 的 文档 注释 
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2.4 发 布 .NET Core 应 用 项 目 


实例 26 在 Visual Studio 中 发 布 . NET Core 应 用 


【导语 】 

当 应 用 程序 的 开发 与 测试 工作 完成 后 ,将 其 发 布 之 后 就 可 以 在 其 他 机 器 上 运行 了 。 对 
于 ASP.NET Core 项 目 ,一 般 发 布 后 会 上 传 到 服务 器 中 运行 。 

本 实例 演示 将 如 何 通过 Visual Studio 开发 环境 提供 的 发 布 向 导 界 面 来 发 布 应 用 程序 
项 目 。 

【操作 流程 】 


窒 "MyApp"(1 个 项 目 ) 


步骤 1: 在 Visual Studio 中 新 建 一 个 控制 台 应 用 程序 项 目 。 国 四 二 


做 出 生成) 
Pr 


步骤 2: 打开 “解决 方案 资源 管理 器 "窗口 , 右 击 项 目 名 称 ， 
从 打开 的 菜单 中 选择 “发 布 ”命令 ,如 图 2-33 所 示 。 

步骤 3: 对 于 一 般 应 用 程序 , 仅 支 持 文件 目录 方式 发 布 , 也 
就 是 将 发 布 后 的 文件 复制 到 指定 的 目录 中 。 默 认 发 布 目 录 位 于 人 
当前 项 目的 bin\Release\PublishOutput 子 目 录 中 ,如 果 需 要 更 改 图 2-33 执行“ 发布" 命令 
目录 ,可 以 单 击 “ 浏 览 ?按钮 ,然后 选择 一 个 目录 ,如 图 2-34 所 示 。 


重新 生成 (E) 


选取 发 布 目标 
口 六 二 | 


bin\Release\PublishOutput 


创建 配置 文件 P) ~ 取消 加 


图 2-34 选择 发 布 目录 
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步骤 4: 向 导 对 话 框 右 下 角 的 按钮 旁边 有 一 个 下 三 角 按钮 , 单 击 后 可 以 选择 发 布 行为 。 
可 选项 为 “创建 配置 文件 ”和 “立即 发 布 "。 选 择 “ 立 即 发 布 " 后 会 马上 启动 发 布 操作 ,对 应 用 
程序 代码 进行 编译 并 把 生成 的 文件 复制 到 发 布 目录 中 。 笔 者 建议 选用 “创建 配置 文件 ”, 这 
样 可 以 先 对 相关 参数 进行 设置 .再 执行 发 布 行为 。 

步骤 5: 如 图 2-35 所 示 , 如果 需要 修改 配置 参数 ,可 以 单 击 “ 设 置 " 链 接 , 如 图 2-36 所 
示 , 修 改 完 成 后 单 击 “ 确 定 ” 按 钮 保存 。 


发 布 


梅 应 用 发 布 到 Azure 或 另 一 台 主机 - 


忆 Folderprofile 发 布 (P) 


摘要 


目标 位 置 bin\ blishOutput 大 
配置 Release 


目标 框 加 


图 2-35 新 建 的 发 布 配置 


配置 文 件 设 轩 


配置 文件 名 称 :Folderprofile 
Release 
netcoreapp2.0 


可 移植 


bin\Release\PublishOutput 


图 2-36 ”修改 发 布 配 置 
步骤 6: 单 击 “ 发 布 ”按钮 ,发 布 操作 随即 启动 ,等 待 其 自动 完成 即 可 。 
注意 : 普通 应 用 只 可 以 采用 目录 方式 发 布 ,而 对 ASP. NET Core 应 用 程序 项 目 而 言 ,不 仅 


可 以 将 应 用 程序 发 布 到 指定 目录 ,还 可 以 将 项 目 发 布 到 远程 服务 器 上 ,例如 使 用 FTP 
上 传 ,或 直接 发 布 Web 应 用 到 Azure 云 上 。 
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实例 27 使 用 Visual Studio 发 布 可 独立 运行 的 项 目 
【导语 】 
默认 发 布 所 生成 的 应 用 程序 文件 ,必须 依赖 . NET Core 运行 库 才能 正常 运行 。 而 通过 手 
动 定义 特定 的 目标 平台 ,能 够 生成 可 以 直接 运行 的 应 用 程序 , 即 前 面 提 到 的 “ 自 包 含 " 模 式 。 
使 用 * 自 包含 ”模式 发 布 的 程序 文件 可 以 直接 复制 到 目标 机 器 上 和 运行, 无须 事先 安装 
.NET Core Runtime。 由 于 该 发 布 方式 会 把 依赖 的 . NET 类 库 复制 到 发 布 目录 中 ,所 以 显 
而 易 见 的 缺点 就 是 文件 体积 大 ,会 出 现 许多 重复 文件 。 
【操作 流程 
步骤 1: 在 “解决 方案 资源 管理 器 ”窗口 中 右 击 项 目 名 称 ,执行 “编辑 < 项 目 名称 > 
. csproj ”命令 ,其 中 ,< 项 目 名 称 >. csproj 是 项 目 文件 。 
步骤 2: 此 时 会 用 文本 编辑 器 打开 项 目 文件 ,项 目 文件 本 身 就 是 一 个 XML 文档 。 NET 
Core 应 用 程序 的 项 目 文件 比较 简洁 ,主体 内 容 如 下 。 
< Project Sdk = "Microsoft. NET. Sdk"> 
< PropertyGroup> 
< OutputType > Exe </OutputType > 
< TargetFramework > netcoreapp2. 0 </TargetFramework > 
</PropertyGroup> 
</Project > 
其 中 TargetFramework 元 素 指定 目标 框架 的 版 本 ,目前 版 本 号 为 2.0。 
步骤 3: 在 PropertyGroup 结 点 下 添加 RuntimeIdentifiers 元 素 ,并 指定 目标 平台 。 
<PropertyGroup > 
<RuntimeIdentifiers> win— x64;l1inux — x64;osx 一 x64</RuntimeIdentifiers > 
</PropertyGroup > 
上 面 配置 使 应 用 程序 分 别 支持 64 位 的 Windows、Linux 和 MacOS 操作 系统 。 多 个 平 
台 标 识 之 间 用 半角 分 号 隔 开 。 
注意 : Runtimeldentifiers 元 素 支持 添加 多 个 目标 平台 ,也 可 以 使 用 RuntimeIdentifier, 但 
Runtimeldentifier 元 素 只 能 添加 单个 目标 平台 。 例 如 : 


< RuntimeIdentifier > win10-x64 </RuntimeIdentifier > 


步骤 4: 保存 并 关闭 文本 编辑 窗口 ,重新 打开 发 布 配置 文件 设置 对 话 框 ,此 时 “目标 运行 
时 ”的 下 拉 列 表 框 中 能 够 选择 目标 平台 ,如 图 2-37 所 示 。 
步骤 5: 选择 一 个 平台 (例如 win-x64) ,然后 就 可 以 发 布 特定 平台 的 应 用 程序 了 ,而 且 


Folderprofile 


Release 


netcoreapp2.0 


win-x64 
linux-x64 
osx-x64 
win-x64 
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图 2-37 可 以 选择 目标 平台 


此 发 布 方式 所 生成 的 文件 是 “ 自 包 含 " 模 式 的 。 


如 图 2-38 所 示 ,发 布 后 生成 的 文件 列表 有 三 部 分 : 第 一 部 分 是 . NET Core 类 库 文件 ; 


第 二 部 分 是 一 个 . exe 文件; 第 三 部 分 是 一 个 . dl 文件 。 应 用 程序 代码 编译 到 . dll 文件 


而 . exe 文件 仅 作为 程序 启动 器 。 


图 mscordaccore.dll 

图 mscordaccore amd64 amd64 4.6.00001.0.dll 
图 mscordbidll 

图 mscorlib.dll 

同 mscorrcdebug.dll 

mscorrcdll 

转 MyApp.depsjson 

图 MyApp.dll 

国 MyApp.exe 

口 MyApp.pdb 

转 MyApp.runtimeconfigjson 

图 netstandard.dll 

图 sosdll 

图 Sos.NETCore.dll 

图 sos amd64 amd64 4.6.00001.0.dll 

图 System.AppContext.dIl 

图 System.Buffers.dll 

图 System.Collections.Concurrentdll 

图 System.Collections.dll 

国 System.CollectionsImmutable -dll 
ystem.Collections.,NonGeneric.dll 
System.Collections.Specialized.dll 

图 System.ComponentModelAnnotations.dll 
图 System.ComponentModeLComposition.dll 
园 System.ComponentModel.DataAnnotations.dll 
图 System.ComponentModelLdll 


十 


图 System.ComponentModel.EventBasedAsync.dll 
园 System.ComponentModel.Primitives.dll 

图 System.ComponentModelTypeConverter.dll 

司 System.Configuration.dIl 

System.Console.dll 

国 System.Core.dll 

国 System.Data.Common.dll 

图 System.Data.dll 

图 System.Diagnostics.Contracts.dll 

图 system.Diagnostics. Debug.dll 

国 system.Diagnostics.DiagnosticSource.dl 

图 System.Diagnostics.Fleversionlnfo.dll 

司 System.Diagnostics Process.dl 

图 System.Diagnostics.StackTrace.dIl 

图 System.Diagnostics.TextWriterTracelistener.dll 
图 System.DiagnosticsTools.dll 


司 System.Diagnostics.TraceSource.dl 


园 System.Diagnostics.Tracing.dll 

国 System.dll 

国 System.Drawing.dll 

辕 System.Drawing.Primitives.dll 

图 system.Dynamic.Runtime.dll 

图 System.Globalization.Calendars.dll 
图 System.Globalization.dll 

图 system.Globalization Extensions ,dll 
周 SystemJO.Compressiondll 


图 2-38 “ 自 包含 "发 布 后 输出 的 文件 
步骤 6: 在 “命令 提示 符 ” 窗 口中 输入 . exe 文件 的 名 字 , 可 以 直接 运行 应 用 程序 ,如 


图 2-39 所 示 。 
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国 C\Windows\System32\cmd.exe 


hDutput 


图 2-39 直接 运行 应 用 程序 
用 于 指定 各 个 平台 的 标识 符 可 以 从 runtime. json 文件 中 获取 ,该 文件 默认 存储 在 C: 和 


Program Files\dotnet\sdk\NuGetFallbackFolder\ microsoft. netcore. platforms\< 版 本 号 > 
目录 下 。 以 下 摘录 该 文件 的 部 分 内 容 ( 参 见 代 码 清单 2-4) 。 
代码 清单 2-4 ”runtime. json 文件 (局 部 ) 


E 
"runtimes": { 
"base": { 
}, 
"any": { 


"# import": [ "base" ] 


"android": { 
"# import": [ "any 
}, 
"android — arm" : 
"# import": [ "any 
}, 
"android— arm64": { 
"# import": [ "any" 


}, 


"# import": [ "any" 


}, 
"win— x86": { 
"# import": [ "win" 
}, 
"win— x64": { 
"# import": [ "win" 


}, 


"win10": { 
"# import": [ "win81" ] 
}, 
"win10 — x86": { 
"# import": [ "win10", "win81 — x86" ] 
}, 
"win10 — x64": { 
"# import": [ "win10", "win81 — x64" ] 


}, 
mine: 人 

"# import": [ "any" ] 
}, 


"unix— x64": { 
"# import": [ "unix" ] 


}, 


"# import": [ "unix" ] 
}, 
SEE 一 证 CS A 
"# import": [ "osx", "unix— x64" ] 


}, 


由 
"# import": [ "osx" ] 
}, 
"osx.10.10— x64": { 
"# import": [ "osx.10.10", "osx— x64" ] 


}, 
"linux": { 

"# import": [ "unix" ] 
}, 


"linux— x64": { 
"#import": [ "linux", "unix— x64" ] 


}, 


"centos": { 
"#import": [ "rhel" ] 


第 2 章 


应 
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}, 
"centos 一 x64": { 

"# import": [ "centos"，"rhel 一 x64" ] 
}, 


"opensuse. 42.1— corert": { 
"# import": [ "opensuse.13.2— corert", "opensuse. 42.1" ] 
}, 
"opensuse. 42.1— x64— corert": { 
"# import": [ "opensuse. 42. 1 — corert", "opensuse. 13. 2 - x64 - corert", 
"opensuse. 42.1— x64" ] 
}, 


} 


其 中 ,#import 属性 表示 向 下 兼容 。 例 如 ,win-x64 可 以 兼容 win7-x64 和 win10-x64， 
ubuntu-x86 可 以 兼容 ubuntu. 15. 04-x86 。 


实例 28 ”使 用 dotnet 命令 行 工 具 发 布 “ 自 包含 "项目 


【导语 】 

除了 可 通过 Visual Studio 开发 环境 来 发 布 “ 自 包含 "项目 ( 即 可 以 独立 运行 的 项 目 ) 外 ， 
还 可 以 使 用 . NET Core 命令 行 工具 一 一 dotnet 来 发 布 。 

在 使 用 dotnet 工具 发 布 项 目 之 前 ,可 以 使 用 实例 27 中 介绍 的 方法 编辑 项 目 文件 ,在 文 
件 中 加 入 < Runtimeldentifiers > 或 < Runtimeldentifier > 元 素 , 以 指定 要 发 布 的 目标 平台 , 当 
然 这 是 可 选 的 。 当 没有 在 项 目 文件 中 指定 目标 平台 时 ,编译 器 也 能 根据 传递 给 dotnet 命令 
的 -r 参数 来 输出 符合 目标 平台 的 可 执行 文件 (能 在 目标 平台 上 直接 运行 的 文件 ) 。 

【操作 流程 】 

步骤 1: 在 任意 目录 下 新 建 一 个 目录 ,命名 为 Demo。 


md Demo 

步骤 2: 进入 Demo 目录 。 

cd Demo 

步骤 3: 创建 一 个 新 的 控制 台 应 用 程序 项 目 。 
dotnet new console 


步骤 4: 本 例 将 发 布 可 以 在 Debian(Linux 系统 ) 上 独立 运行 的 应 用 程序 ,输入 以 下 
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dotnet publish —c release —r debian— x64 


其 中 -c 参数 指定 要 生成 的 版 本 ,在 调试 阶段 ,可 以 指定 为 debug 版 本 ; 在 正式 发 布 时 ,应 当 
使 用 release 版 本 。 本 实例 直接 使 用 release 版 本 ,该 版 本 会 生成 极 少 (或 者 没有 ) 调 试 信息 ， 
可 提升 程序 执行 效率 。-r 参数 指定 目标 平台 ,例如 win7-x64、linux-x86、ubuntu-x64 等 ,本 
实例 使 用 debian-x64。 


注意 : -r 参数 只 能 指定 一 个 目标 平台 ,如 果 有 多 个 要 发 布 的 目标 平台 ,可 以 多 次 执行 dotnet 
publish 命令 ,并 且 指 定 不 同 的 -r 参数 。 


步骤 $: 执行 完 发 布 命令 后 ,在 “\bin\release\netcoreapp < 版 本 号 >\< 目 标 平台 >” 目 录 
下 会 生成 应 用 程序 文件 ,并 且 在 publish 子 目 录 下 会 包含 应 用 程序 文件 以 及 依赖 的 所 有 运 
行 时 库 。 

步骤 6: 在 Debian 系统 上 执行 发 布 的 应 用 程序 前 ,需要 安装 两 个 依赖 的 包 , 请 执行 以 下 
命令 进行 安装 

sudo apt install libunwind8 libicu57 


ICU 软件 包 支持 对 UTF-8 等 Unicode 编码 的 处 理 。 
步骤 7: 把 publish 目录 下 的 所 有 文件 复制 到 Debian 系统 上 。 
步骤 8: 定位 到 Demo 文件 所 在 目录 。 


cd < 具体 路 径 > 
步骤 9: 输入 程序 文件 名 , 即 可 执行 。 
. /Demo 
注意 : 在 Linux 操作 系统 上 执行 程序 文件 ,需要 在 文件 前 面 加 上 “./”。 


步骤 10: 如 果 输 出 *Hello World!1”, 说 明 程序 已 正常 运行 。 
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C# 语言 基 础 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 使 用 命名 空间 ; 

。 变量 与 常量 ; 

。 声明 程序 人 口 点 ; 

”流程 控制 。 


3.1 命名 空间 


实例 29 使 用 namespace 关键 字 


【导语 】 

命名 空间 有 两 个 作用 : 一 是 把 各 种 类 型 按照 用 途 进 行 分 组 ,二 是 解决 命名 冲突 。 

第 一 个 作用 是 将 类 型 归 类 , 例如 在 . NET 类 库 中 , 有 一 个 System, Security. 
Cryptography 命名 空间 ,根据 其 命名 ,可 以 知道 在 该 命名 空间 下 面 的 类 型 与 安全 技术 有 关 ， 
并 且 包含 用 于 加 密 或 解密 的 API。 

对 于 第 二 个 作用 ,假设 用 户 在 程序 代码 声明 两 个 类 型 ,它们 的 名 字 都 是 P, 虽 然 名 字 相 
同 , 但 两 个 P 类 型 的 功能 是 完全 不 同 的 。 为 了 解决 同名 冲突 ,就 可 以 分 别 把 两 个 P 类 型 放 
在 不 同 的 命名 空间 下 ,例如 第 一 个 P 类 型 放 在 N1 命名 空间 下 ,全 名 称 为 N1.P, 再 把 第 二 
个 P 类 型 放 在 N2 命名 空间 下 ,全 名 称 为 N2. P。 这 样 N1.P 与 N2.P 就 不 再 发 生命 名 冲 
突 了 。 

定义 命名 空间 使 用 namespace 关键 字 ,定义 后 就 可 以 将 类 型 放置 在 命名 空间 中 。 

【操作 流程 】 

步骤 1: 在 Visual Studio 开发 环境 中 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 新 建 项 目 后 ,会 自动 打开 项 目 模板 生成 的 Program. cs 文件 。 从 生成 的 代码 中 
可 以 看 到 ,默认 的 命名 空间 与 项 目 名 字 相 同 , 例 如 ,用 户 给 项 目 命名 为 Demo, 那 么 代码 默认 
的 命名 空间 同样 为 Demo。 如 代码 清单 3-1 所 示 。 


C# 语 言 


代码 清单 3-1 模板 生成 的 命名 空间 


namespace Demo 


{ 


} 
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在 Demo 命名 空间 下 ,有 一 个 Program 类 (用 class 关键 字 声 明 ) ,Program 类 下 面 还 有 


代码 清单 3-2 ”模板 生成 的 完整 程序 结构 


using Systenm; 


namespace Demo 
{ 
class Program 
{ 
static void Main(string[ ] args) 
{ 
Console. WriteLine("Hello World! "); 
} 


} 


一 个 Main 方法 , 它 是 整个 程序 的 入 口 点 , 即 应 用 程序 会 从 Main 方法 开始 执行 , 当 退 出 
Main 方法 后 ,程序 也 随 之 退出 。 完 整 结构 如 代码 清单 3-2 所 示 。 


步骤 3: 在 项 目 生 成 的 命名 空间 外 ( 即 命 名 空间 的 右 大 括号 外 ) 另 起 新 行 ,使 用 


namespace 关键 字 声 明 一 个 Test 命名 空间 。 


namespace Test 
{ 
E 


一 对 大 括号 。 


注意 : 命名 空间 是 一 种 容器 ,里 面 可 以 包含 类 型 ,属于 代码 块 ,因此 在 命名 空间 后 面 要 加 上 


步骤 4: 在 定义 好 的 Test 命名 空间 两 个 大 括号 之 间 定 义 一 个 Car 类 。 声 明 类 使 用 


class 关键 字 ,class 也 是 一 种 类 型 。 


namespace Test 

{ 
public class Car 
{ 


} 
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注意 ; 类 型 内 部 可 以 包含 类 型 成 员 , 因 此 类 定义 之 后 也 要 附加 一 对 大 括号 。 


步骤 5: 在 Car 类 中 再 定义 一 个 方法 。 


namespace Test 
{ 
public class Car 


{ 
public void Run() 


{ 
Console. WriteLine(" 开 车 啦 。"); 


当 调用 Run 方法 时 ,会 在 控制 台 窗 口 输出 文本 信息 。 
步骤 6: 回 到 Program 类 的 Main 方法 ,用 以 下 代码 替换 默认 生成 的 代码 。 


static void Main(string[ ] args) 
Test. Car c = new Test.Car(); 
c. Run(); 

E 

上 面 代 码 首 先 声 明 一 个 Car 类 型 的 变量 c, 并 且 通 过 new 关键 字 进 行 实例 化 ,然后 调用 
Run 方法 。 

步骤 7: 按 F6 快捷 键 生成 解决 方案 。 

步骤 8: 打开 “命令 提示 符 " 窗 口 , 定 位 到 项 目 文件 目录 下 的 \bin\Debug\netcoreapp 
< 版 本 号 > 子 目 录 下 。 

步骤 9: 输入 以 下 命令 ,执行 应 用 程序 。 


dotnet < 项 目 名 称 >. d11 


步骤 10: 如 果 看 到 输出 文本 “开车 啦 ”, 说 明 程 序 已 经 正确 执行 。 


实例 30 ” 详 套 命名 空间 


【导语 】 

命名 空间 下 面 不 仅 可 以 包含 类 型 ,还 可 以 嵌 套 命名 空间 。 即 命名 空间 A 下 面 可 以 包含 
命名 空间 B, 命 名 空间 B 下 面 还 可 以 包含 命名 空间 C。 

【操作 流程 

步骤 1: 新建 控制 台 应 用 程序 .命名 为 Demo。 

步骤 2: 在 生成 的 Demo 命名 空间 之 外 , 另 声明 一 个 命名 空间 ,命名 为 NTest。 
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namespace NTest 


{ 


. 
步骤 3: 在 NTest 命 名 空间 下 再 声明 两 个 命名 空间 ,分 别 命名 为 NSubl、NSub2。 


namespace NTest 

{ 
namespace NSubl 
{ 


} 


namespace NSub2 
{ 


} 
， 


步骤 4: 在 NSubl 命名 空间 下 声明 一 个 类 ,命名 为 WorkTask。 


class WorkTask 


{ 


} 
步骤 5: 在 NSub2 命名 空间 下 ,声明 一 个 名 为 Tool 的 结构 。 


struct Tool 


{ 


} 
此 时 NTest 命名 空间 的 内 部 结构 如 代码 清单 3-3 所 示 。 
代码 清单 3-3 ”NTest 命名 空间 的 完整 代码 


namespace NTest 


{ 


namespace NSubl 


{ 


class WorkTask 


t 


} 
} 


namespace NSub2 
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struct Tool 


} 


} 


步骤 6: 回 到 Program 类 的 Main 方法 ,在 方法 体 中 分 别 使 用 刚才 定义 的 两 个 类 型 来 声 
明 变 量 。 


static void Main(string[ ] args) 

{ 
NTest. NSubl. WorkTask v1 = null; 
NTest. NSub2. Tool] v2; 

} 


引用 类 型 时 ,加 上 其 所 在 的 命名 空间 名 字 ,每 一 层 命 名 空间 用 半角 句点 分 隔 。 


注意 : 谋 套 命名 空间 主要 是 以 “. ”运算 符 分 隔 。 在 实际 编写 代码 时 ,并 不 一 定 要 求 命名 空间 
之 间 有 广 套 格式 ,例如 本 实例 中 的 代码 结构 也 可 以 写 为 : 
namespace NTest. NSubl 


class WorkTask 


{ 
} 
namespace NTest. NSub2 


struct Tool 


上 


实例 31 引入 命名 空间 


【导语 】 

使 用 using 指令 可 以 在 代码 中 引入 命名 空间 。 引 入 命名 空间 后 ,在 代码 中 访问 某 个 类 
型 时 就 不 必 敲 入 命名 空间 的 名 字 ,使 代码 更 简洁 ,可 读 性 更 高 。 

using 指令 可 以 在 以 下 两 处 使 用 : 

(1) 代码 文件 顶部 ,在 所 有 代码 之 前 。 此 处 所 引入 的 命名 空间 ,可 以 在 整个 代码 文件 中 
使 用 。 不管 当 前 代码 文件 中 有 和 多少 个 命名 空间 ,有 多 少 个 类 型 , 均 可 使 用 。 
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(2) 在 某 个 命名 空间 内 。 此 处 只 在 当前 命名 空间 内 有 效 ,在 当前 命名 空间 以 外 不 可 用 。 

本 实例 将 以 System. Collections 命名 空间 下 的 类 型 进行 演示 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 此 时 会 自动 打开 Program. cs 文件 。 文档 顶 部 默认 已 经 引入 了 System 命名 空 
间 ,在 第 一 行 using 指令 后 面 ,引入 System. Collections 命名 空间 。 


using System; 
using System. Collections; 


步骤 3: 在 Main 方法 中 实例 化 一 个 ArrayList 对 象 ,并 向 其 中 添加 三 个 字符 串 实例 。 


ArrayList mylist = new ArrayList(); 

mylist. Add("Tom"); 

mylist. Add("Jim"); 

mylist. Add( "Jack" ); 

ArrayList 是 一 个 容量 可 自动 增长 的 数组 类 型 ,可 以 向 其 添加 任意 类 型 的 元 素 。 

如 果 没 有 使 用 using 指令 引入 System. Collections 命名 空间 ,那么 在 访问 ArrayList 类 
的 时 候 就 必须 写 上 完整 的 命名 空间 ,例如 : 


System. Collections. ArrayList mylist = new System.Collections.ArrayList(); 


这 样 代码 会 变 得 元 长 ,而 且 阅 读 起 来 也 不 方便 。 尤 其 是 在 一 个 代码 文件 中 多 处 使 用 同 
一 个 命名 空间 时 ,通过 using 指令 在 文档 的 项 部 引入 后 ,不 必 在 代码 中 重复 输入 命名 空间 。 


步骤 4: 输出 ArrayList 对 象 中 所 有 元 素 。 

foreach(object o in mylist) | 

{ 

Console. WriteLine(o); 

$ 图 3-1 输出 ArrayList 
cd 本 实例 中 的 元 素 

步骤 5: 运行 应 用 程序 ,输出 结果 如 图 3-1 所 示 。 

实例 32 在 命名 空间 内 部 引入 其 他 命名 空间 


【导语 】 

using 指令 既 可 以 在 代码 文档 的 顶部 使 用 ,也 可 以 在 某 个 命名 空间 内 部 使 用 ,此 时 要 注 
意 所 引入 的 命名 空间 只 在 当前 命名 空间 中 有 效 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 ,并 命名 为 Demo。 

步骤 2: 在 生成 的 Program. cs 文件 中 ,会 创建 默认 的 Demo 命名 空间 。 请 读者 手动 把 
Demo 命名 空间 外 部 的 using 指令 代码 (模板 默认 生成 ) 删 除 。 

步骤 3: 在 Demo 命名 空间 内 部 加 入 以 下 using 指令 。 
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namespace Demo 


using System; 
using System. Collections. Generic; 


步骤 4: 实例 化 一 个 List < int > 对 象 , 并 添加 4 个 元 素 。 
List< int> list = new List< int> 


100,200,300 


如 果 不 引 入 System. Collections. Generic 命名 空间 ,那么 在 访问 List < T > 类 时 就 要 写 
上 完整 的 命名 空间 。 


System. Collections. Generic. List < int > list = new System.Collections.Generic.List< int> 
{ 

100, 200,300 
}; 


注意 ; 由 于 System. Collections. Generic 命名 空间 是 在 Demo 命名 空间 中 引入 的 ,所 以 在 
Demo 命 名 空间 以 外 的 代码 要 访问 List < 了 > 类 就 必须 使 用 System. Collections. 
Generic. List < 本 >, 而 不 能 直接 使 用 List< 工 >。 


实例 33 ”使 用 全 局 命名 空间 

【导语 】 

应 用 程序 项 目 隐藏 着 一 个 根 命名 空间 , 即 全 局 命名 空间 。 全 局 命名 空间 可 以 包含 项 目 
中 的 所 有 类 型 的 访问 范围 ,包括 项 目 中 所 引用 的 其 他 组 件 。 

由 于 根 命名 空间 是 隐 式 存在 的 , 它 没有 明确 的 名 称 , 所 以 访问 它 就 必须 使 用 global 关 
键 字 。 该 关键 字 一 般 用 来 解决 类 型 与 命名 空间 的 命名 冲突 问题 ,在 以 下 实例 中 进行 演示 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 一 个 嵌 套 的 类 ,命名 为 System。 


class Program 


{ 


public class System { } 
static void Main( string[ ] args) 


. 


} 
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步骤 3: 在 Main 方法 中 尝试 实例 化 System. Version 类 。 
System. Version v = new System. Version(); 


此 时 会 发 生 错 误 , 因 为 此 处 被 识别 为 上 面 定义 的 System 类 ,而 且 System 类 中 没有 髓 
套 的 Version 类 , 即 编译 器 把 System. Version 识别 为 System 类 的 组 套 类 Version 。 

步骤 4: 如 果 要 使 用 System 命名 空间 下 的 Version 类 ,就 必须 显 式 加 上 global 关键 字 ， 
通过 全 局 命名 空间 强制 指向 System 命名 空间 下 的 Version 类 。 


global: :System. Version v = new global: :System. Version(); 


此 时 ,编译 器 就 能 正确 识别 System. Version 类 。 


实例 34 为 引入 的 命名 空间 设置 别名 


【导语 】 

尽管 命名 空间 在 类 型 声明 阶段 解决 了 命名 冲突 的 问题 ,然而 该 冲突 在 引入 命名 空间 后 
依然 会 出 现 。 例 如 ,命名 空间 A 下 面 有 一 个 Product 类 ,完整 名 称 为 A. Product; 命名 空间 
B 下 面 也 有 一 个 Product 类 ,完整 名 称 为 B. Product。 如 果 将 A、B 两 个 命名 空间 同时 引入 ， 
那么 在 代码 中 直接 访问 Product 类 会 发 生 歧 义 , 即 编译 器 无 法 判断 使 用 了 哪个 命名 空间 下 
的 Product 类 。 

如 果 命 名 空间 的 名 称 比较 短 ( 如 上 面 举 例 中 的 A、B), 则 访问 类 型 时 可 以 把 命名 空间 写 
全 , 即 在 代码 中 使 用 A. Product 或 B. Product; 但 是 如 果 命 名 空间 的 名 称 很 长 ,在 代码 中 访 
问 类 型 会 显得 元 长 。 例 如 把 上 面 举例 中 的 A 命名 空间 改 为 Company. Parts. WorkItems ,把 
B 命 名 空间 改 为 Company. Parts. CheckedItems, 那么 访问 Product 类 时 就 要 写 上 
Company. Parts. WorkItems. Product 或 Company. Parts. CheckedItems. Product。 很 明显 ， 
这 样 写 出 来 的 代码 并 不 简洁 。 

要 解决 这 个 问题 ,可 以 在 引入 命名 空间 时 分 配 一 个 别名 。 例 如 为 上 面 的 Company. 
Parts. WorkItems 分 配 一 个 别名 W .这样 访 问 Product 类 时 就 可 以 写 上 W. Product。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program. cs 文件 中 定义 两 个 命名 空间 。 


namespace Organization. Component. Extensions 


{ 
} 
namespace Organization. Component. MainParts 


{ 


} 
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步骤 3: 在 以 上 两 个 命名 空间 内 ,分 别 声 明 一 个 BackgroundWork 类 。 


namespace Organization. Component. Extensions 
{ 

public class BackgroundWork { } 
} 
namespace Organization. Component. MainParts 
{ 

public class BackgroundWork { } 


} 
步骤 4: 在 代码 文件 项 部 使 用 using 指令 引入 上 面 定义 的 两 个 命名 空间 ,并 为 它们 分 配 
一 个 简短 的 别名 。 


using ext = Organization.Component. Extensions; 


using mps Organization. Component. MainParts; 


步骤 5: 在 代码 中 访问 BackgroundWork 类 时 ,就 可 以 加 上 命名 空间 的 别名 。 虽 然 多 了 
个 前 级 ,但 由 于 别名 比较 简短 ,代码 看 起 来 依然 很 简洁 。 


ext. BackgroundWork bwl = new ext.BackgroundWork(); 
mps. BackgroundWork bw2 = new mps.BackgroundWork(); 


实例 35 使 用 using static 指令 


【导语 】 

使 用 using static 指令 ,可 以 像 引 入 命名 空间 那样 引入 某 个 类 型 (该 类 型 是 静态 类 或 者 
包含 静态 成 员 ) 。 引 入 类 型 后 ,在 代码 中 访问 其 静态 成 员 时 可 以 省 略 类 型 名 称 。 

本 例 以 System 命名 空间 下 比较 有 代表 性 的 两 个 类 来 做 演示 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 文件 的 顶部 ,使 用 using static 指令 引入 Console 和 Math 两 个 类 。 


using static System. Console; 
using static System. Math; 


步骤 3: 此 时 访问 Console. WriteLine 方法 可 以 不 写 Console 类 的 名 称 。 
WriteLine("Hello World! "); 
步骤 4: 同样 ,访问 Math 类 也 不 用 写 类 名 Math。 


WriteLine( $ "5 的 平方 为 :{Pow(5d, 2d)}"); 
WriteLine( $" -650 的 绝对 值 是 :{Abs( -650)}"); 
WriteLine( $ "16,33 中 最 小 的 数 是 :{Min(16, 33)}"); 


其 中 Abs、Pow 以 及 Min 都 是 Math 类 公开 的 静态 方法 ,如 果 不 使 用 using static 指令 ， 
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则 上 面 三 行 代码 就 应 写成 


Console. WriteLine( $ "5 的 平方 为 :{Math. Pow(5d, 2d)}"); 
Console. WriteLine( $" - 650 的 绝对 值 是 :{Math. Abs( - 650)}"); 
Console. WriteLine( $ "16,33 中 最 小 的 数 是 :{Math. Min(16, 33)}"); 


显然 ,使 用 了 using static 指令 后 ,代码 可 以 更 简练 。 
3.2 变量 与 常量 


实例 36 一 次 性 声明 多 个 变量 

【导语 】 

变量 的 声明 语法 如 下 。 

< 类 型 > < 变量 名 > 

类 型 名 称 与 变量 名 称 之 间 要 有 空格 。 对 于 同一 类 型 的 多 个 变量 ,可 以 逐个 声明 ,例如 
int x; 

int y; 

int z; 

其 实 , 可 以 一 次 性 声明 多 个 类 型 相同 的 变量 , 即 按照 以 下 格式 在 一 行 代码 中 同时 声明 。 
nt xr;, y, 


【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 此 时 默认 会 打开 Program. cs 文件 。 

步骤 3: 在 Main 方法 中 声明 三 个 string 类 型 的 变量 。 
string a; 


string b; 
string c; 


步骤 4: 可 以 在 一 行 代码 中 同时 声明 这 三 个 变量 (变量 之 间 用 半角 逗号 分 隔 ) 。 
stringa, b, c; 
步骤 5: 也 可 以 在 声明 变量 时 进行 赋值 。 


stringd = null,e = "", f = "food"; 


实例 37 让 编译 器 自动 推断 变量 的 类 型 


【导语 】 
在 声明 变量 时 ,可 以 使 用 var 关键 字 来 描述 类 型 ,编译 器 会 根据 代码 给 变量 的 赋值 来 扒 
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断 其 类 型 。 因 此 ,在 使 用 var 关键 字 声 明 变量 后 要 马上 给 变量 赋值 ,否则 编译 器 无 法 推断 变 
量 的 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 使 用 var 关键 字 声 明 一 个 变量 abc, 并 为 其 赋值 。 


var abc = 3.141d; 


数值 3. 141 带 有 后 级 d, 表 示 该 数值 为 double 类 型 ( 双 精 度 浮 点 数 ) ,因此 编译 器 推断 出 
变量 abc 的 类 型 为 System. Double。 
步骤 3: 可 以 使 用 以 下 代码 来 输出 变量 abc 的 类 型 。 


Console. WriteLine( $ "变量 abc 的 类 型 为 :{abc. GetType().FullName}"); 


GetType 方法 返回 一 个 Type 对 象 ,该 对 象 描述 与 类 型 有 关 的 详细 信息 。 应 用 程序 运 
行 之 后 ,将 输出 以 下 文本 。 


变量 abc 的 类 型 为 :System.Double 


注意 : 使 用 var 关键 字 声 明 的 变量 必须 初始 化 , 即 声 明 后 必须 马上 赋值 。 因 为 编译 器 需要 
通过 分 配给 变量 的 值 来 推断 其 类 型 ,如 果 没有 赋值 ,编译 器 就 不 知道 变量 是 什么 类 
型 了 。 


实例 38 ”使 用 常量 


【导语 】 

常量 与 变量 相对 ,变量 的 * 变 ”意味 着 在 声明 并 初始 化 之 后 ,可 以 在 后 续 的 代码 中 修改 变 
量 的 值 ; 而 常量 的 “ 常 "意味 着 一 旦 初始 化 之 后 ,后 续 代码 无 法 修改 常量 的 值 。 

为 了 直观 地 看 出 变量 与 常量 的 区 别 ,本 实例 将 同时 使 用 变量 与 常量 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 变量 x 并 初始 化 ,然后 在 屏幕 上 输出 一 次 。 


int x = 10; 
Console. WriteLine( $ "修改 前 ,变量 x 的 值 :{x}"); 


步骤 3: 把 变量 x 的 值 改 为 100, 再 输出 一 次 。 


x = 100; 
Console. WriteLine( $ "修改 后 ,变量 x 的 值 :{x}"); 


变量 x 在 初始 化 时 设 定 为 10, 然 后 代码 把 它 的 值 修改 为 100, 此 时 运行 代码 屏幕 上 会 输 
出 以 下 文本 。 
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修改 前 ,变量 x 的 值 :10 
修改 后 ,变量 x 的 值 :100 


步骤 4: 声明 常量 Z, 必 须 在 声明 后 立即 初始 化 。 
const int 2 = 500; 


声明 常量 的 方法 与 变量 类 似 ,只 是 要 加 上 const 关键 字 。 
步骤 5: 以 下 代码 试图 修改 常量 Z 的 值 。 


Z = 700; // 此 行 代码 会 报错 
常量 的 值 一 旦 初始 化 ,是 不 能 被 修改 的 ,所 以 上 面 这 行 代码 会 发 生 编译 错误 。 


注意 : 按照 习惯 ,常量 的 名 称 使 用 的 是 全 大 写 的 字母 。 但 这 只 是 习惯 ,并 不 是 语法 要 求 。 


实例 39 获取 变量 的 内 存 地 址 


【导语 】 

在 C++ 语言 中 ,通过 指针 变量 或 者 引用 运算 符 (&), 可 以 获得 变量 的 内 存 地 址 。 在 C# 
中 ,尽管 有 一 些 限制 ,仍然 可 以 进行 类 似 的 处 理 。 

指针 操作 在 C# 语 言 中 被 认为 是 不 安全 的 ,因此 ,如 果 要 使 用 指针 变量 , 则 必须 将 相关 
的 代码 写 在 unsafe 代码 块 中 ,或 者 在 方法 的 声明 中 加 入 unsafe 修饰 符 。 

例如 ,以 下 代码 在 unsafe 代码 块 中 声明 指针 类 型 的 变量 。 


byte b = 255; 
unsafe 


{ 
bytex pb = &b; 
上 
以 上 代码 在 方法 声明 中 加 入 unsafe 修饰 符 , 表 示 该 方法 内 部 的 代码 中 会 出 现 不 安全 
代码 。 


unsafe void DoSomething( ) 
{ 
float 上 = 0.0077f; 
float* pf = gf; 
} 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 打开 “解决 方案 资源 管理 器 "窗口 , 右 击 项 目 名 称 ,从 菜单 中 选择 “属性 ”命令 。 
步骤 3: 此 时 会 打开 项 目 属性 窗口 ,然后 切换 到 “生成 ”选项 卡 。 
步骤 4: 在 “常规 ?分 组 下 , 匀 选 “允许 不 安全 代码 ”, 如 图 3-2 所 示 。 
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条 件 编译 符 S(W: 。 |NETCOREAPP2 0 
回 定义 DEBUG 常量 (U) 
回 定义 TRACE 常量 中 
平台 目标 (G): [any CPU 


图 3-2 人 允许 使 用 不 安全 代码 
步骤 5: 回 到 Program. cs 文件 ,在 Main 方法 上 加 上 unsafe 修饰 符 。 


static unsafe void Main( string[ ] args) 
{ 
} 


步骤 6: 声明 一 个 int 类 型 的 变量 并 初始 化 。 

int val = 200; 

步骤 7: 声明 一 个 指向 int 类 型 的 指针 ,并且 引用 变量 的 地 址 。 

intx p = gval; 

步骤 8: 为 了 能 够 获取 并 输出 指针 变量 所 包含 的 地 址 ,还 需要 将 其 转换 为 IntPtr 类 型 。 


IntPtr ptr = (IntPtr)p; 

Console. WriteLine( $ "变量 的 地 址 :{ptr. ToString("x")}"); 

指针 类 型 并 非 从 Object 类 派生 ,所 以 它 没有 ToString 方法 。 要 想 在 代码 中 输出 指针 
指向 的 内 存 地 址 ,需要 将 其 转换 为 IntPtr 类 型 。 


实例 40 输出 变量 的 名 称 


【导语 】 

在 应 用 程序 中 输出 变量 的 名 称 ,实际 就 是 获得 变量 名 称 的 字符 串 表示 形式 ,这 需要 用 到 
nameof 运算 符 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 打开 的 Program. cs 文件 中 找到 Main 方法 ,在 方法 体内 部 声明 四 个 变量 ,并 
进行 初始 化 。 

string strvar = "hello"; 

int intvar = 3600; 
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var singlevar = 7.115f; 
var longvar = 6560000L; 


在 代码 中 使 用 不 带 任何 后 级 的 数值 表示 整 型 数值 (32 位 整数 ) , 带 后 级 {的 表示 单 精 度 
浮 点 数值 , 带 LL 后 级 的 数值 为 长 整 型 数值 (64 位 整数 ) 。 

步骤 3: 将 变量 的 名 称 与 实 值 输出 到 屏幕 。 

Console. WriteLine( $ "变量 {nameof(strvar)} 的 值 为 {strvar}。"); 

Console. WriteLine( $ "变量 {nameof (intvar)} 的 值 为 {intvar}。"); 


Console. WriteLine( $ "变量 {nameof (singlevar)} 的 值 为 {singlevar}.") 
Console. WriteLine( $ "变量 {nameof (longvar)} 的 值 为 {longvar}.。"); 


步骤 4: 按 F5 快捷 键 运行 应 用 程序 ,屏幕 输出 如 图 3-3 所 示 。 


图 3-3 输出 变量 的 名 称 


注意 : nameof 运算 符 不 仅 可 以 获取 变量 /常量 的 名 称 , 它 还 可 以 用 于 代码 文档 中 的 任何 对 
象 ,例如 可 以 获取 命名 空间 名 、 类 型 名 、 类 型 成 员 名 等 。nameof 运算 符 能 返回 对 象 名 
称 的 字符 串 表 示 形 式 ,一般 可 用 于 向 用 户 输 出 变量 名 ,或 者 某 些 需要 以 字符 串 形式 提 
供 对 象 名 称 的 情况 ,例如 通过 反射 技术 动态 查找 类 型 的 特定 成 员 。 


实例 41 为 变量 分 配 默 认 值 

【导语 】 

在 声明 变量 时 可 以 为 其 分 配 一 个 初始 值 , 也 可 以 使 用 类 型 的 默认 值 。 例 如 ,int 类 型 的 
默认 值 为 0, 类 (class) 的 默认 值 是 null。 

要 获取 某 个 类 型 的 默认 值 ,建议 使 用 default 关键 字 ,该 关键 字 能 自动 返回 指定 类 型 的 
默认 值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 int 类 型 和 一 个 string 类 型 的 变量 ,分 别 用 default 关键 字 分 配 默 
认 值 。 

intv = default(int); 

string s = default(string); 


步骤 3: 在 屏幕 上 输出 两 个 变量 的 值 。 


Console.WriteLine( $ "int 类 型 的 默认 值 :{v}"); 
Console. WriteLine( $ "string 类 型 的 默认 值 :{s ?? "null"}"); 
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于 string 类 型 的 默认 值 是 null, 但 是 null 在 屏幕 中 无 法 输出 ,所 以 这 里 用 了 一 个 ?? 
运算 符 , 其 意思 是 : 如 果 字 符 串 变量 不 为 null, 就 输出 字符 串 内 容 ; 如 果 字 符 串 为 null ,就 输 
出 字符 串 “null”。 

步骤 4: default 关键 字 , 还 有 更 简洁 的 写法 ,就 是 不 必 指 定 类 型 。 例 如 上 面 声明 变量 的 
代码 可 以 改 为 


intv = default; 

string s = default; 

步骤 5: 此 时 需要 更 改 项 目 使 用 的 C# 语 言 版 本 ,版 本 号 不 低 于 7.1。 打 开 “ 解 决 方案 
资源 管理 器 "窗口 ,在 项 目 名 称 上 碳 击 ,从 菜单 中 选择 “属性 ,打开 项 目 属性 窗口 。 

步骤 6: 切换 到 “生成 ”选项 页 ,在 页 面 底部 找到 并 单 击 “ 高 级 "按钮 。 

步骤 7: 语言 版 本 选择 7. 1 或 以 上 ,或 者 选择 “最 新 次 要 版 本 (最 新 )”, 然 后 单 击 “ 确 定 ” 
按钮 ,如 图 3-4 所 示 。 


语言 版 本 (LD): C# 最 新 主要 版 本 (默认 ) 
C# 最 新 主要 版 本 (默认 ) 
内 部 帝 译 器 错误 报告 ()。 | Cx 最 新 次 要 版 本 (最 新 ) 


ISO-1 
[me > 


坊 出 一 一 一 一 一 |C#3 
C#4 
调试 信息 (E): C#5 
C#6 

文件 对 齐 (P: Ce 7.0 

库 基 址 (B): C# 7.2 


图 3-4 选择 语言 版 本 


注意 : 由 于 default 关键 字 的 这 项 增强 功能 是 在 C# 7.1 中 推出 的 ,因此 需要 修改 项 目 使 用 
的 语言 版 本 。 


3.3 程序 入 口 点 


实例 42 ”获取 命令 行 参 数 


【导语 】 
程序 人 口 点 , 即 应 用 程序 开始 执行 的 位 置 , 进 入 入口 点 后 ,代码 会 一 直 往 下 执行 ; 当代 
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码 退 出 入 口 点 后 ,应 用 程序 也 会 退出 ,整个 应 用 程序 生命 周期 结束 。 

程序 人 口 点 是 一 个 静态 方法 ,必须 命名 为 Main。Main 方法 中 一 般 会 有 一 个 字符 串 数 
组 类 型 的 参数 ,该 参数 用 于 接收 传递 给 应 用 程序 的 命令 行 参数 。 

【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 项 目 。 

步骤 2: 项 目 模板 默认 会 生成 Program 类 ,并 包含 一 个 Main 方法 ( 即 程序 入 口 点 )。 


static void Main(string[ ] args) 
{ 


. 
步骤 3: 输入 以 下 代码 ,在 屏幕 上 输出 命令 行 参数 。 


StringBuilder sbd = new StringBuilder(); 

sbd. AppendLine( "接收 到 的 命令 行 参数 :"); 

foreach (string a in args) 

{ 

sbd. AppendFormat(" {0}", a); 

} 

Console. WriteLine( sbd); 

应 用 程序 接收 到 的 命令 行 参 数 会 传递 给 Main 方法 的 参数 args, 数 组 中 每 个 元 素 都 是 
一 个 参数 。 

步骤 4: 要 在 调试 时 传递 命令 行 参数 ,需要 打开 “解决 方案 资源 管理 器 "窗口 ,然后 右 击 
项 目 名 称 , 从 菜单 中 执行 “属性 "命令 ,打开 项 目 属性 窗口 。 

步骤 5: 在 项 目 属性 窗口 中 切换 到 “调试 "选项 卡 。 

步骤 6: 在 “应 用 程序 参数 ” 右 侧 的 文本 框 中 输入 三 个 测试 参数 。 


= 


参数 之 间 用 空格 隔 开 ,如 图 3-5 所 示 。 


启 让 项 目 
应 用 程序 参数 : 三 省 


图 3-5 输入 用 于 测试 的 参数 


步骤 7: 按 F5 快捷 键 运行 应 用 程序 ,在 控制 台 窗口 中 就 能 看 到 传递 的 命令 行 参数 了 ， 
如 图 3-6 所 示 。 

步骤 8: 如果 使 用 dotnet 命令 直接 执行 应 用 程序 ,可 以 把 需要 传递 的 参数 附加 在 . dll 文 
件 名 后 面 。 


58 二 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


dotnet Demo.dll 一 hello — world 


其 中 Demo. dll 是 项 目 编译 后 生成 的 程序 文件 。-hello 和 -world 是 命令 行 参数 。 
步骤 9: 执行 上 述 命令 后 ,会 输出 如 图 3-7 所 示 的 内 容 。 


图 3-6 输出 的 命令 行 参数 图 3-7 使 用 命令 行 执行 程序 


实例 43 处理 多 个 人 口 点 

【导语 】 

一 个 应 用 程序 只 能 有 一 个 入 口 点 ,但 是 在 程序 代码 中 是 可 以 定义 多 个 Main 方法 的 。 
如 果 应 用 程序 项 目 中 包含 多 个 Main 方法 ,只 能 从 中 选择 一 个 作为 程序 的 入 口 点 。 

【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 项 目 。 

步骤 2: 项 目 模板 会 生成 一 个 Program 类 以 及 Main 方法 。 

步骤 3: 另 定义 一 个 Test 类 ,并 在 其 中 也 声明 一 个 Main 方法 。 


class Test 
{ 
static void Main( string[ ] args) 
{ 
Console. WriteLine(" 第 二 个 人 口 点 。"); 
Console.Read( ); 


注意 : Main 方法 必须 是 静态 的 (static) ,但 不 要 求 是 公共 的 (public) 。 


步骤 4: 由 于 项 目 中 包含 了 两 个 Main 方法 ,此 时 运行 项 目 会 出 现 以 下 错误 。 
错误 ”CS0017 程序 定义 了 多 个 人 口 点 。 使 用 /main (指定 包含 人 口 点 的 类 型 ) 进 行 编 译 。 


步骤 5: 打开 项 目 属性 窗口 ,切换 到 * 应 用 程序 ”选项 卡 , 在 “启动 对 象 "下 拉 列 表 框 中 选 
择 一 个 包含 Main 方法 的 类 ,如 图 3-8 所 示 。 此 时 应 用 程序 就 能 正常 运行 了 。 


3-8 选择 一 个 入 口 点 
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3.4 流程 控制 


实例 44 奇数 还 是 偶数 


【导语 】 
让 语句 能 够 对 代码 的 执行 进行 分 支 处 理 , 其 用 法 如 下 : 
证 ( < 条 件 > ) 


{ 
代码 段 1 


代码 段 2 
} 
其 中 “< 条 件 >” 是 一 个 表达 式 , 其 结果 为 布尔 类 型 ( 真 或 假 )。 如 果 “< 条 件 >” 成 立 ( 为 真 ) ,就 
执行 “代码 段 1”, 和 否则 (为 假 ) 就 执行 “代码 段 2”。 
如 果 代码 逻辑 只 有 一 个 分 支 ,else 子 句 可 以 省 略 , 即 : 


证 ( < 条 件 > ) 


代码 段 1 

} 
当 “< 条 件 >” 成 立时 ,“ 代 码 段 1” 被 执行 ; 如 果 条 件 不 成 立 , 直接 
跳 过 “代码 段 1”。 

执行 本 实例 时 由 用 户 输入 一 个 数值 ,然后 程序 判断 该 数值 
是 奇数 还 是 偶数 ,最 后 将 结果 输出 到 屏幕 上 ,如 图 3-9 所 示 。 图 3-9 判断 数值 的 奇偶 性 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 Console 类 的 ReadLine 方法 读 取 用 户 从 键盘 输入 的 内 容 。 


string input = Console. ReadLine(); 
其 中 ,ReadLine 方法 返回 一 个 字符 串 实例 , 它 表示 用 户 输入 的 文本 ,用 户 可 以 一 次 性 输入 多 
个 字符 ,并 按 Enter 键 确 认 。 

步骤 3: 得 到 用 户 输入 的 内 容 后 ,还 需要 对 内 容 的 有 效 性 进行 验证 。 因 为 用 户 有 可 能 输 
入 了 非 数 字 字 符 ( 例 如 输入 了 字母 ) ,而 且 本 实例 要 求 是 大 于 0 的 整数 ,例如 : 


if(uint. TryParse( input, out uint number) && number > 0) 
{ 


} 
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else 
{ 
Console. WriteLine(" 你 输入 的 内 容 无 效 。"); 
| 
其 中 ,TryParse 方 法 能 够 对 字符 串 进行 分 析 , 验 证 其 能 不 能 转换 为 uint 值 (无 符号 整数 ) ,如 
果 能 转换 ,就 把 转换 后 得 到 的 值 保存 到 变量 number 中 ,并且 TryParse 返回 true; 如 果 无 法 
转换 ,方法 会 返回 false。 
此 时 计 语 句 的 判断 条 件 由 两 个 因素 组 成 。 首 先 ,输入 的 文本 必须 是 有 效 的 整数 ; 其 次 ， 
该 数值 必须 是 大 于 0 的 。 两 个 表达 式 用 运算 符 &&. 连接 ,表示 只 有 当 两 个 表达 式 同 时 成 立 
时 ,让 语 句 的 判断 条 件 才 会 成 立 ; 如 果 其 中 有 一 个 不 成 立 , 那 么 整个 判断 条 件 也 不 成 立 。 
步骤 4: 确保 用 户 输 入 的 数值 有 效 后 ,就 可 以 分 析 其 奇偶 性 了 。 
if(uint. TryParse(input, out uint number) && number > 0) 
{ 
// 判断 整数 的 奇偶 性 
if((number % 2) == 0) 
L; 


Console. WriteLine( $ "你 输入 的 {number} 是 偶数 ."); 
} 
else 
{ 
Console. WriteLine( $" 你 输入 的 {number} 是 奇数 。"); 
} 
| 


else 
{ 
Console. WriteLine(" 你 输入 的 内 容 无 效 。"); 
} 
奇偶 性 的 判断 依据 为 : 数值 是 否 能 被 2 整除 。 这 里 的 处 理 方法 是 让 number 变量 的 值 
除 以 2 并 取 其 余数 ,如 果 余 数 为 0 说 明 可 被 2 整除 , 即 为 偶数 ,否则 是 奇数 。 运 算 符 % 用 于 
获取 两 个 数 相 除 后 的 余数 。 


注意 : 本 实例 使 用 了 广 套 的 这 语句 , 即 在 这 语句 的 代码 块 中 又 包含 一 层 计 语句 ,在 一 些 复 杂 
的 逻辑 处 理 中 是 允许 使 用 多 层 岩 套 的 语句 的 。 


实例 45 使 用 for 循环 输出 文本 
【导语 】 

for 循环 的 用 法 如 下 : 

for ( < 变量 初始 值 > ; < 循环 条 件 >; < 修改 变量 > ) 
{ 


代码 片段 
} 


和 
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首先 通过 “< 变量 初始 值 >” 表 达 式 对 变量 (一 般 是 整数 值 的 类 型 ,如 int\long 等 ) 进 行 初始 化 
( 设 定 初 值 ) ,然后 启动 循环 , “代码 片段 ”处 的 代码 会 被 执行 。 执 行 完 “代码 片段 ”后 会 执行 
“< 修改 变量 >” 表 达 式 ,对 变量 的 值 进 行 修改 (通常 是 加 上 1) ,接着 使 用 “< 循环 条 件 >” 判 断 是 
否 再 需要 进行 循环 。 如 果 条 件 依然 成 立 , 则 “代码 片段 ”处 的 代码 又 会 执行 ; 如 果 “< 循 环 条 


件 >” 不 成 立 ,就 会 跳出 for 循环 。 不断 地 循环 往返 ,直到 跳出 for 语句 块 。 

【操作 流程 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 运用 for 循环 ,在 屏幕 上 输出 5 行文 本 : 

for (intn = 1;n<= 5; nt+) 

{ 

Console. WriteLine( $ "这 是 第 {n} 行文 本 。"); 

} 
其 中 变量 n 初始 化 为 1 ,循环 的 条 件 是 n 要 小 于 或 等 于 5, 每 次 循环 
过 后 都 会 让 n 加 上 1。 例如 ,第 一 轮 循环 ,n 的 值 为 1, 输出 “这 是 第 
1 行文 本 ”, 然 后 回 到 for 语句 块 起 点 ,将 n 的 值 加 1, 变 为 2,2 小 于 
5, 因 此 条 件 成 立 ,继续 循环 ,输出 “这 是 第 2 行文 本 ”; 依 此 类 推 , 直 
到 mn 的 值 等 于 6 时 ,循环 条 件 不 再 成 立 ,就 会 退出 循环 。 运行 效果 
如 图 3-10 所 示 。 


实例 46 生成 由 字符 组 成 的 图 案 


【导语 】 
本 实例 是 在 前 面 的 实例 基础 上 增强 的 。 首 先 ,通过 循环 产生 以 下 图 案 : 


* 


3-10 
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把 上 面 的 图 案 中 每 一 行进 行 反 转 , 即 
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循环 输出 的 文本 
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接着 反 转 所 有 行 , 得 到 


美 关 闪闪 尖 关 美美 尖 关 关 关 关 关 关 关 关 


闫 关 闫 闫 美美 美 。。 尖 关 关 关 关 关 关 
关 关 关 关 关 关 关 关 关 关 关 关 
关 关 关 关 关 尖 关 关 关 关 
关 关 关 关 关 关 关 关 
关 关 关 关 关 关 
闪闪 关 关 
关 # 


最 后 把 所 有 行 再 做 一 次 反 转 ,并 拼接 到 上 面 各 行 后 面 , 就 能 得 到 如 下 最 终 图 案 。 


辩 关 关 关 闪闪 关 关 关 关 关 关 关 关 关 关 


美 关 关 闪闪 关 关 。。 尖 尖 关 关 关 关 关 
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美 关 关 闪闪 关 关 。。 尖 关 关 关 尖 关 关 


关 关 闪闪 闪光 关 关 闪光 光 关 关 关 兴 


控制 台 最 终 输 出 效果 如 图 3-11 所 示 。 


【操作 流程 】 et 


站 订 六 于 亲 


步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 通过 循环 ,产生 图 案 的 上 半 部 分 。 


List< string> listl = new List< string>(); 
for (intx = 1; x<= 8; x++) 
{ 
String sl = ""; ee 
intv = 0; 1 


while (v<x) 0 
| 


sl += "#"; 图 3-11 程序 最 后 输出 的 图 案 
V++ 1， 

} 

// 其 余 的 字符 用 空格 补 齐 , 使 字符 串 总 长 度 为 8 

sl = sl.PadRight(8); 
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// 将 整 行 字符 进行 反 转 ,并 产生 新 的 字符 串 
string s2 = new string(sl.Reverse().ToArray()); 
// 将 两 个 字符 串 进行 拼接 
listl.Add(sl + s2); 
} 


步骤 3: 将 图 案 中 的 所 有 行 反 转 再 输出 。 
// 第 一 轮 输 出 


listl. Reverse( ); 
foreach (var item in list1) 


{ 


Console. WriteLine( item) ; 


步骤 4: 将 图 案 中 的 所 有 行 再 一 次 反 转 ,继续 输出 。 
// 第 二 轮 输出 


listl. Reverse(); 
foreach (var item in list1) 


{ 
Console. WriteLine( item) ; 


} 


实例 47 死 循 环 的 处 理 方 法 


【导语 】 

所 谓 死 循 环 ,就 是 永 不 休止 的 循环 。 循 环 体内 部 的 代码 会 永久 性 地 执行 ,产生 的 原因 在 
于 循环 条 件 永远 成 立 , 使 得 循环 体 无 法 退出 。 在 实际 编程 中 ,要 避免 出 现 死 循 环 , 一 旦 遇 到 
死 循 环 , 后 续 的 代码 将 无 法 被 执行 。 

如 果 出 于 代码 逻辑 考虑 ,确实 要 设 定 永久 成 立 的 循环 条 件 ( 例 如 ,3 二 5, 因 为 3 确实 小 于 
5, 这 样 的 条 件 永久 成 立 ) ,那么 也 要 在 适合 的 时 候 从 循环 体内 部 退出 循环 。 要 在 循环 体内 部 
退出 循环 ,可 以 使 用 break 语句 ,例如 : 


while (3<5) 


if (.…) 


【操作 流程 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 在 Main 方法 中 设置 一 个 死 循 环 。 
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while (9==9) 
{ 

Console. WriteLine( $"{DateTime. Now:T} 正在 执行 循环 … …"); 
} 


由 于 9 等 于 9 是 永远 成 立 的 ,所 以 上 面 的 while 循环 
代码 会 永远 地 执行 ,除非 强制 退出 应 用 程序 。 为 了 能 更 好 
地 看 到 Console. WriteLine 方法 被 无 限 次 调用 ,上 面 代码 
中 刻意 在 输出 的 文本 前 面 加 上 当前 时 间 。 

步骤 3: 按 F5 快捷 键 执行 程序 ,会 看 到 如 图 3-12 所 
示 的 输出 。 

步骤 4: 要 让 循环 终止 ,此 时 只 能 强制 关闭 应 用 程序 。 


实例 48 退出 循环 的 方法 


【导语 】 

前 面 提 到 过 ,使 用 break 语句 可 以 退出 循环 ,在 死 循 
环 内 部 更 需要 这 样 做 。 本 实例 将 实现 : 在 死 循环 执行 过 
程 中 ,只 要 用 户 按 下 下 键 , 就 可 以 退出 循环 。 

【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 项 目 

步骤 2: 在 Main 方法 内 设 定 .个 死 循环 。 图 3-12 应 用 程序 在 执行 死 循 环 


while (true) 


{ 


循环 条 件 始 终 是 true, 表 明 这 个 条 件 是 永远 成 立 的 ,因此 这 是 一 个 死 循环 。 
步骤 3: 在 死 循环 内 部 ,加 退出 循环 的 条 件 。 


while (true) 
{ 
Console. WriteLine(" 请 按 E 键 退出 ."); 
if(Console. ReadKey(true). Key == ConsoleKey.E) 
{ 
break; 


} 
当 用 户 按 下 玉 键 后 ,使 用 break 语句 退出 循环 。 
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实例 49 输出 20 以 内 能 被 3 整除 的 正 整数 


【导语 】 

break 语句 会 直接 退出 整个 循环 ; 而 continue 语句 则 会 跳 过 本 轮 循环 ,重新 回 到 循环 代 
码 的 顶部 执行 下 一 轮 循环 ,循环 并 不 会 退出 。 

本 实例 将 执行 一 个 从 1 到 20 的 循环 ,如 果 当 前 数值 能 被 3 整除 就 将 其 输出 ,否则 就 跳 
过 本 次 循环 。 例 如 ,当前 数值 为 5, 不 能 被 3 整除 , 则 直接 跳 过 ,不 再 往 下 执行 ,而 是 继续 下 

- 轮 循 环 ; 然后 当前 数值 变 为 6, 可 以 被 3 整除 ,于 是 就 输出 数值 6。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 使 用 for 循环 对 1 到 20 的 正 整数 进行 试验 , 找 出 能 被 3 整除 的 数 。 


for(int i = 1; i<= 20; i++) 


{ 
if ((i % 3) != 0) 
continue; 
Console. Write(" {0}", i); 
} 


当 数 值 不 能 被 3 整除 ( 即 除 以 3 后 余数 不 为 0) 时 ,执行 continue 语句 跳 过 本 次 循环 ; 如 
果 可 以 被 3 整除 ,就 输出 该 数值 。 
步骤 3: 按 F5 快捷 键 运行 程序 ,输出 结果 如 图 3-13 所 示 。 


图 3-13 20 以 内 可 被 3 整除 的 正 整数 


实例 S50 ”做 一 道 选择 题 

【导语 】 

switch 语句 首先 提取 指定 表达 式 的 值 , 然 后 将 该 值 与 各 个 case 开关 所 表示 的 分 支 进行 
匹配 ,如 果 与 其 中 一 个 分 支 的 值 相 等 ,那么 就 执行 该 case 开关 下 的 代码 。 

switch 语法 如 下 : 

switch ( < 匹配 表达 式 > ) 

{ 


case nl: 
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break; 
Case n2: 


break; 
default: 
ed 
} 
每 个 分 支 后 都 要 加 上 break、goto、return 等 语句 ,是 为 了 避免 代码 把 后 面 的 分 支 都 执 
行 ,如 果 某 个 分 支 匹 配 后 就 继续 执行 后 面 的 分 支 , 就 损坏 分 支 语句 的 逻辑 结构 了 。default 
分 支 是 可 选 的 ,如 果 上 面 各 个 case 都 不 匹配 , 则 执行 default 分 支 的 代码 。 
本 实例 将 模拟 一 道 选择 题 , 用 户 通过 输入 选择 进行 作答 ,代码 会 对 用 户 选择 进行 分 析 ， 
并 给 出 被 选项 的 说 明 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 设 定 一 道 有 4 个 选项 的 选择 题 。 
Console. WriteLine(" 请 问 ,以 下 哪 位 历史 人 物 生活 在 唐 朝 ?"); 
Console. WriteLine("1、 蔡 洲 "); 
Console. WriteLine("2 唐寅") 


Console. WriteLine("3、 王 勃 "); 
Console. WriteLine("4、 苏 轼 ") ; 


步骤 3: 读 取 用 户 输入 。 


string input = Console. ReadLine(); 


ReadLine 方法 读 取 整 行文 本 并 返回 , 按 下 Enter 键 进行 确认 。 
步骤 4: 对 用 户 输入 的 选项 字符 串 进行 分 析 。 


switch (input) 
{ 
Case "1": 
Console. WriteLine(" 蔡 当 生 活 在 东汉 时 期 。"); 
break; 
case "2": 
Console. WriteLine(" 唐 寅 是 明 朝 人 。"); 
break; 
Cse "37 
Console. WriteLine(" 恭 喜 你 ,答对 了 。") ; 
break; 
Case "4": 
Console. WriteLine( "苏轼 生活 在 北宋 时 期 。"); 
break; 
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default: 
Console. WriteLine(" 你 未 做 出 有 效 选择 。"); 
break; 


y CNProgram Files\dot.. 


哪 位 内 


如 果 用 户 选择 “3”, 就 会 输出 “恭喜 你 ,答对 了 ”; 如 
果 用 户 选择 “1” ,并非 正 确 答案 ,因而 告诉 用 户 * 蔡 对 生 
活 在 东汉 时 期 ”。 

步骤 5: 按 下 F5 快捷 键 ,运行 应 用 程序 ,输入 一 个 


选项 ,然后 按 Enter 键 确认 ,如 图 3-14 所 示 。 图 3-14 选择 一 个 答案 
实例 S1 switch 语句 的 类 型 匹配 
【导语 】 


switch 语句 中 的 case 开关 除了 可 以 匹配 常量 外 ,还 可 以 匹配 类 型 。 当 测试 表达 式 的 类 
型 能 够 与 某 个 case 子 语句 所 指定 的 类 型 相 匹 配 时 ,就 会 执行 该 case 分 支 的 代码 。 代 码 清 剖 


3-4 演示 了 类 型 匹配 的 简单 用 法 。 


代码 清单 3-4 ”switch 语句 类 型 匹配 示例 
object vx = "abcde"; 
switch (vx) 
{ 
case int n: 
// 这 是 一 个 整数 值 
break; 
case string t: 
// 这 是 字符 串 
break; 
default: 
// 未 知 类 型 
break; 
i 


变量 声明 为 object 类 型 ,而 实际 赋值 时 使 用 了 string 类 型 的 值 。 第 一 个 case 子 语句 需 
要 int 类 型 的 值 ,类 型 不 匹配 ,因此 此 分 支 不 会 执行 ; 第 二 个 case 子 语句 需要 的 是 string 类 
型 的 值 ,类 型 匹配 ,所 以 该 分 支 会 被 执行 。 
在 使 用 类 型 匹配 时 ,一 定 要 注意 类 型 的 兼容 性 问题 ,例如 以 下 有 A、B、C 三 个 类 ,其 
B 类 从 A 类 派生 ,C 类 从 B 类 派生 。 


classA{} 
classB:A{} 
classC:B{} 


然后 在 switch 语句 中 使 用 类 型 匹配 。 
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object o = new B(); 
Switch (o) 
{ 


Case Ax: 


// A.B\C 类 型 的 实例 均 匹配 
break; 

Case Bx: 
// 只 有 B.C 类 型 的 实例 匹配 
break; 

Case Cx: 


// 只 有 C 类 型 的 实例 匹配 
break; 
} 


这 段 代码 无 法 通过 编译 ,而 且 在 Visual Studio 的 代码 编辑 器 中 也 会 提示 错误 ,错误 的 
原因 是 第 二 个 与 第 三 个 case 分 支 是 永远 不 会 被 执行 的 。 第 一 个 case 子 语 句 匹 配 类 型 为 A， 
即 无 论 测 试 表 达 式 中 的 实例 是 A 类 型 ,B 类 型 还 是 C 类 型 ,都 能 够 与 该 case 分 支 匹配 ,这 是 
因为 A.B、C 三 种 类 型 的 实例 都 能 赋值 给 A 类 型 的 变量 。 

要 解决 该 错误 ,最 简单 的 方法 就 是 调换 各 case 子 句 的 顺序 , 即 把 代码 改 为 : 


Switch (o) 
{ 


Case Cx: 
// A、B.C 类 型 的 实例 均 匹 配 
break; 

case Bx: 
// 只 有 BC 类 型 的 实例 匹配 
break; 

case Ax: 
// 只 有 C 类 型 的 实例 匹配 
break; 

} 


修改 后 ,如 果 测 试 表达 式 是 C 类 型 的 实例 ,那么 它 只 能 匹配 第 一 个 case 分 支 ; 同 理 ,如 果实 
例 是 B 类 型 , 它 无 法 赋值 给 C 类 型 的 变量 ,所 以 只 能 匹配 第 二 个 case 分 支 ; 如 果实 例 是 A 
类 型 , 它 无 法 赋值 给 B 和 C 的 变量 ,只 能 匹配 第 三 个 case 分 支 了 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 object 类 型 的 变量 ,并 赋 一 个 double 类 型 的 数值 。 

object obj = 0.0001d; 

步骤 3: 使 用 switch 语句 进行 类 型 匹配 。 


switch (obj) 
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case int v: 
Console. WriteLine( $ "{v} 是 一 个 int 值 ."); 
break; 

case decimal v: 
Console. WriteLine( $ "{v} 是 一 个 decimal 值 ."); 
break; 

case double v: 
Console.WriteLine( $ "{v} 是 一 个 double 值 ."); 
break; 

default: 
Console. WriteLine( "未知 类 型 。"); 
break; 


国 C\Progra.. 


} 

上 述 代码 中 ,只 有 第 三 个 case 子 语句 能 够 匹配 ,因为 
obj 变量 的 实际 值 为 double 类 型 。 屏幕 输 出 如 图 3-15 图 3-15 匹配 double 类 型 表达 式 
所 示 。 


实例 52 在 case 语句 中 使 用 when 子 句 


【导语 】 

case 语句 后 除了 使 用 常量 值 外 ,还 可 以 进行 类 型 匹配 。 为 了 让 类 型 匹配 更 加 精确 ,可 以 
在 case 语句 后 加 上 when 子 语句 。when 子 语句 所 使 用 的 表达 式 必须 返回 布尔 值 ,只 有 当 
when 子 语句 返回 true 时 ,该 case 语句 才 会 被 执行 。 

所 以 ,when 子 语句 就 相当 于 给 case 分 支 增加 一 个 额外 的 条 件 , 以 进行 更 细致 的 筛选 。 
例如 ,通过 类 型 匹配 可 以 匹配 出 一 个 数组 对 象 实例 ,可 是 这 个 数组 有 可 能 是 空 数 组 (元 素 个 
数 为 0) ,在 case 分 支 处 理 时 ,开发 者 可 能 会 考虑 当 出 现 空 数组 时 做 另外 处 理 , 此 时 ,when 子 
语句 就 发 挥 作用 了 。 以 下 代码 在 switch 语句 块 中 设 定 两 个 case 分 支 , 这 两 个 分 支 都 接受 数 
组 类 型 的 对 象 ,只 是 其 中 一 个 明确 接受 空 数组 。 


Case Array arr when arr. Length == 0: 


break; 
Case Array arr: 


break; 


下 面 的 实例 将 会 进一步 演示 when 子 句 的 用 法 。 

【操作 流程 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 生成 的 Program 类 中 增加 一 个 静态 方法 。 该 方法 接收 一 个 object 类 型 的 参 
数 ,并 使 用 switch 语句 块 进行 分 支 处 理 , 详 见 代 码 清单 3-5。 
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代码 清单 3-5 ”DisplayInfo 方 法 


static void DisplayInfo(object instance) 


{ 
switch (instance) 
{ 
case null: 
Console. WriteLine(" 对 象 未 实例 化 。"); 
break; 


Case Array arr when arr. Length == 0: 
Console. WriteLine(" 这 是 个 空 数组 ."); 
break; 
Case Array arr: 
Console. WriteLine( $ "数组 包含 {arr. Length} 个 元 素 。"); 


break; 

case IList ls when 1s.Count == 0: 
Console. WriteLine(" 这 是 个 空 列 表 。"); 
break; 


case IList 1s: 
Console. WriteLine( $ "列表 总 共有 {1s. Count} 项 ."); 
break; 


} 


null 值 不 会 匹配 任何 类 型 ,所 以 要 作为 一 个 常量 值 来 筛选 。 在 使 用 when 子 语句 时 一 
定 要 把 握 好 case 的 顺序 。 例 如 上 面 代码 中 对 空 数组 的 分 析 , 假 设 把 两 个 case 语句 做 以 下 
调换 。 

Case Array arr: 

Console. WriteLine( $ "数组 包含 {arr. Length} 个 元 素 。"); 
break; 

case Array arr when arr. Length == 0: 

Console. WriteLine(" 这 是 个 空 数组 ,"); 
break; 

这 样 会 发 生 编译 错误 。 因 为 不 论 数 组 中 是 否 包含 元 素 . 第 一 个 case 语句 都 能 匹配 ,这 样 
会 使 得 第 二 个 case 语句 永远 无 法 匹配 ,等 同 于 第 二 个 case 语句 后 的 代码 永远 不 会 被 执行 。 

步骤 3: 分 别 向 DisplayInfo 方法 传递 不 同 的 对 象 进行 测试 。 


// 测试 一 : 空 引用 
DisplayInfo(nul1); 
// 测试 二 : 空 数组 


int[] intarr = { }; 
DisplayInfo( intarr); 
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// 测试 三 : 空 列表 
List< long> listet = new List< long>(); 
DisplayInfo(listet); 


// 测试 四 :包含 元 素 的 数组 
byte[ ] btarr = { 36, 2, 54, 7 }; 
DisplayInfo(btarr); 


// 测试 五 :包含 列表 项 的 列表 


List< int> listint = new List< int> { 21, 13, 62, 8, 19 }; 


DisplayInfo(listint); 
步骤 4: 按 下 F5 快捷 键 运行 项 目 , 会 看 到 如 图 3-16 所 示 图 3-16 when 子 句 演示 结果 
的 输出 。 


实例 53 ”代码 跳 转 

【导语 】 

在 代码 文档 中 ,可 以 在 某 段 代码 前 写 上 标签 ,然后 在 代码 的 其 他 位 置 使 用 goto 关键 字 
跳 转 到 指定 的 标签 处 ,并 继续 执行 标签 后 的 代码 。 


注意 : 此 处 所 说 的 标签 是 在 代码 逻辑 上 定义 的 标签 ,而 非 在 Visual Studio 中 为 代码 设置 的 
标签 。 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 定义 五 处 标签 , 详 见 代码 清单 3-6 。 
代码 清单 3-6 ”在 Main 方法 中 定义 五 处 标签 


left: 
Console. WriteLine(" 你 按 下 了 左 方向 键 ."); 
Console. Read( ); 


return; 


right: 
Console. WriteLine(" 你 按 下 了 右 方 向 键 ."); 
Console. Read( ); 


return; 


up: 
Console. WriteLine(" 你 按 下 了 向 上 键 ."); 


Console. Read( ); 
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return; 


down: 
Console. WriteLine(" 你 按 下 了 向 下 键 ."); 
Console. Read( ); 
return; 


other: 
Console. WriteLine(" 你 按 下 了 其 他 键 ."); 
Console. Read( ); 

return; 


标签 的 定义 方法 是 在 标签 名 称 后 面 紧 跟 一 个 英文 的 冒号 。 上 面 代码 在 每 个 标签 后 的 代 
码 中 都 加 上 了 Console. Read 方法 的 调用 以 及 return 语句 ,这 是 为 了 防止 代码 继续 往 下 执 
行 。 例 如 ,假设 代码 跳 转 到 left 标签 处 ,那么 left 标签 后 面 的 所 有 代码 都 会 被 执行 ,包括 下 
面 right up 等 标签 后 面 的 代码 也 会 执行 。 因 为 代码 跳 转 到 某 个 标签 后 ,就 会 从 该 标签 处 继 
续 往 下 执行 ,直到 程序 退出 或 者 没有 可 执行 的 代码 。 

步骤 3: 调用 ReadKey 方法 从 键盘 输入 中 读 取 一 个 键 码 ,并 判断 哪个 键 被 激活 了 。 如 
果 按 下 了 Left 键 ,就 执行 left 标签 后 的 代码 ; 如 果 按 下 了 Right 键 ,就 执行 right 标签 后 的 
代码 ; 如 果 按 下 了 Up 键 ,就 执行 up 标签 后 的 代码 ; 如 果 按 下 了 Down 键 就 执行 down 标 
签 后 的 代码 ; 如 果 按 下 了 其 他 键 ,就 执行 other 标签 后 的 代码 。 


var keyinfo = Console.ReadKey(true) ; 


if (keyinfo. Key == ConsoleKey. LeftArrow) 
goto left; 

else if (keyinfo. Key == ConsoleKey.RightArrow) 
goto right; 


else if (keyinfo. Key == ConsoleKey. UpArrow) 
goto up; 
else if (keyinfo. Key == ConsoleKey. DownArrow) 
1 CProg. — OO Xx 
goto down; 
else 


goto other; 
在 goto 关键 字 后 面 直接 写 上 要 跳 转 的 代码 标签 即 可 。 - 
步骤 4: 运行 项 目 后 ,在 键盘 上 按 下 一 个 键 来 测试 ,结果 如 图 3-17 goto 语句 测试 
图 3-17 所 示 。 


4.1 


面向 对 象 编程 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 类 与 结构 ; 

。 委托 与 事件 ; 

继承 与 多 态 ; 

。 枚 举 ; 

。 特性 ; 

。 运算 符 ; 

。 类 型 转换 ; 

可 以 为 null 的 值 类 型 。 


类 与 结构 


实例 54 ”声明 公共 类 


【导语 】 
类 型 分 为 两 种 : 一 种 是 引用 类 型 ,存储 在 托管 堆 上 ,并 且 变 量 之 间 赋 值 只 复制 实例 引 


用 ,而 不 会 产生 新 实例 ; 另 一 种 是 值 类 型 ,存储 在 栈 内 存 中 ,变量 之 间 赋 值 会 产生 新 实例 。 


inter 
因此 
为 公 


类 (class) 属 于 引用 类 型 。 默认 情 况 下 ,使 用 class 关键 字 声明 的 类 ,其 可 访问 性 为 
nal, 即 只 有 当前 程序 集 内 部 的 代码 才能 访问 它 ,其 他 程序 集中 的 代码 是 无 法 访问 的 。 
,如 果 和 希望 所 声明 的 类 能 够 被 所 有 外 部 代码 访问 ,应 该 明确 使 用 public 修饰 符 , 即 声明 
共 类 5 

【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 生成 的 默认 命名 空间 下 声明 三 个 公共 类 。 


public class Ant { } 


public class Dragonfly { } 
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public class Spider { } 
步骤 3: 在 Main 方法 中 ,分 别 使 用 上 面 声明 的 三 个 类 来 定义 变量 ,并 初始 化 为 默认 值 。 


Ant vl = default(Ant); 
Dragonfly v2 = default(Dragonfly); 
Spider v3 = default(Spider); 


注意 ; 如 果 省 略 public 修饰 符 , 默 认 的 可 访问 性 为 internal, 即 只 有 当前 程序 集 内 部 的 代码 
才能 访问 。 


实例 55 ”为 结构 定义 构造 函数 

【导语 】 

结构 不 允许 声明 无 参数 的 构造 函数 ,因此 如 果 结 构 需 要 声明 构造 函数 ,必须 声明 带 参数 
的 构造 函数 。 一 般 来 说 ,构造 函数 的 参数 用 于 初始 化 结构 中 的 字段 值 。 

由 于 结构 是 值 类 型 ,所 以 声明 变量 后 , 既 可 以 使 用 new 运算 符 来 创建 实例 ,也 可 以 省 
略 。 值 类 型 存储 在 栈 内 存 中 ,声明 变量 后 会 自动 分 配 空间 ,无 须 显 式 创建 实例 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 默认 命名 空间 下 声明 一 个 Rectangle 结构 。 

struct Rectangle 

{ 

public int Width; 
public int Height; 

} 

结构 包含 两 个 公共 字段 (结构 可 以 包含 属性 ,但 常用 字段 ) ,一 般 应 该 添加 public 修饰 
符 , 以 便 其 他 代码 能 访问 字段 。 

步骤 3: 为 Rectangle 结构 定义 带 两 个 参数 的 构造 函数 ,这 两 个 参数 用 来 初始 化 公共 字 
段 的 值 。 

struct Rectangle 

{ 


public int Width; 
public int Height; 


public Rectangle(int w, int h) 
{ 

Width = w; 

Height = h; 


第 4 


步骤 4: 在 Main 方法 中 ,可 以 通过 三 种 方式 创建 Rectangle 结构 的 实例 。 


// 无 须 使 用 new 运算 符 
Rectangle rl1; 

rl.Width = 10; 
rl.Height = 25; 


// 显 式 使 用 new 运算 符 
Rectangle r2 = new Rectangle(); 
r2.Width = 6; 

r2.Height = 17; 


// 使 用 带 参数 的 构造 函数 
Rectangle r3 = new Rectangle(45, 185); 


实例 56 ”构造 函数 的 相互 调用 
【导语 】 
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当 一 个 类 中 存在 多 个 构造 函数 时 ,可 能 会 出 现 构 造 函 数 之 间 互 相 调 用 的 情况 。 其 格式 
为 : 在 当前 构造 函数 后 紧 跟 一 个 半角 冒号 ,然后 使 用 this 关键 字 调 用 其 他 构造 函数 。 例 如 ， 


A 类 有 两 个 版 本 的 构造 函数 , 则 可 以 使 用 以 下 方式 调用 其 构造 函数 。 


public A() 
:this(1000) 


} 
public A(int n) 
{ 

Num = n 


} 


public int Num { get; set; } 


注意 : 在 一 个 构造 函数 中 访问 其 他 构造 函数 ,必须 在 进入 函数 体 之 前 发 生 , 即 在 一 个 构造 函 


数 的 内 部 是 不 能 访问 其 他 构造 函数 的 。 


【操作 流程 】 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 


步骤 2: 如 代码 清单 4-1 所 示 ,声明 一 个 Production 类 ,该 类 包含 三 个 构造 函数 。 
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代码 清单 4-1 Production 类 


/// < summary> 

/// 产品 类 

/// </summary> 

public class Production 


{ 


/// < summary> 

/// 产品 编号 

/// </summary> 

public Guid ProductID { get; set; } 


/// < summary> 

/// 产品 名 称 

/// </summary> 

public string ProductName { get; set; } 


/// < summary> 

/// 生产 日 期 

/// </summary> 

public DateTime ProductDate { get; set; } 


/// < summary> 
/// 带 三 个 参数 的 构造 函数 
/// </summary> 
/// <param name = "pid"> 产 品 编号 </param> 
/// <param name = "pname"> 产 品名 称 </param > 
/// <param name = "pdate"> 生 产 日 期 </param> 
public Production(Guid pid, string pname, DateTime pdate) 
{ 

ProductID = pid; 

ProductName = pname; 

ProductDate pdate; 


} 


/// < summary> 

/// 带 两 个 参数 的 构造 函数 

/// </summary> 

/// < param name = "pname"> 产 品名 称 </param > 

/// <param name = "pdate"> 生 产 日 期 </param> 

public Production( string pname, DateTime pdate) 
:this(Guid. NewGuid(), pname, pdate) 

{ 


上 
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/// < summary> 
/// 不 带 参数 的 构造 函数 
/// </summary> 
public Production() 
:this(Guid. NewGuid()，" 未 知 产品 "，DateTime. Today) 
{ 


} 
} 


三 个 构造 函数 分 别 为 : 


// 没有 参数 的 构造 函数 
public Production( ); 


// 带 两 个 参数 的 构造 函数 
public Production( string pname, DateTime pdate); 


// 带 三 个 参数 的 构造 函数 
public Production(Guid pid, string pname, DateTime pdate) 


其 中 ,只 有 带 三 个 参数 的 构造 函数 才 有 实现 代码 (通过 参数 给 三 个 属性 赋值 ) ,其 他 两 个 构造 
函数 都 是 调用 这 个 构造 函数 ,因此 另外 两 个 构造 函数 的 方法 体内 部 没有 实现 代码 。 
步骤 3: 回 到 Main 方法 ,分 别 使 用 不 同 版 本 的 构造 函数 对 Production 类 进行 实例 化 。 
// 调用 无 参数 的 构造 函数 
Production pl = new Production(); 


Console. WriteLine( $ "产品 编号 :{pl. ProductID}\n 产品 名 称 :{pl. ProductName}\n 生产 日 期 :{pl. 
ProductDate:D} \n"); 


// 调用 有 两 个 参数 的 构造 函数 

Production p2 = new Production(" 示 例 产品 "，new DateTime(2017, 12, 12)); 

Console. WriteLine( $ "产品 编号 :{p2. ProductID}\n 产品 名 称 :{p2. ProductName}\n 生产 日 期 :{p2. 
ProductDate:D}\n"); 


步骤 4: 按 F5 快捷 键 ,运行 应 用 程序 ,输出 结果 如 图 4-1 所 示 。 


4-1 调用 不 同 版 本 的 构造 函数 
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实例 57 静态 构造 函数 


【导语 】 

可 以 直接 访问 静态 成 员 ,无 须 创建 对 象 实例 ,但 不 要 误 以 为 没有 静态 构造 函数 。 常 规 的 
构造 函数 是 在 对 象 实例 化 时 创建 的 ,而 静态 构造 函数 则 是 在 静态 成 员 首 次 被 访问 时 创建 的 。 

静态 构造 函数 在 应 用 程序 运行 期 间 一 旦 被 调用 ,其 后 不 论 代 码 是 否 多 次 访问 静态 成 员 ， 
都 不 会 再 调用 静态 构造 函数 。 如 果 代 码 从 不 访问 静态 成 员 ,那么 静态 构造 函数 永远 不 会 被 
调用 。 

【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 类 ,并 在 类 中 定义 一 个 静态 属性 。 


public class Test 


{ 
public static string Sample { get; } 


} 
该 属性 只 有 get 访问 器 ,表示 它 是 只 读 属性 。 
步骤 3: 在 类 中 定义 静态 构造 函数 ,在 构造 函数 内 部 为 静态 属性 初始 化 。 


static Test() 
{ 

Sample = "演示 属性 "; 

Console. WriteLine(" 静 态 构造 函数 被 调用 。"); 
} 


步骤 4: 回 到 Main 方法 ,对 静态 属性 进行 三 次 访问 。 


Console. WriteLine(Test. Sample); 
Console. WriteLine(Test. Sample); 


Console. WriteLine(Test. Sample); 

步骤 5: 按 F5 快捷 键 运行 项 目 , 从 输出 结果 可 以 看 
到 ,尽管 静态 成 员 被 访问 了 三 次 ,但 是 只 调用 了 一 次 静态 
构造 函数 ,如 图 4-2 所 示 。 


图 4-2 静态 构造 函数 只 调用 一 次 


注意 : 静态 构造 函数 一 般 用 于 初始 化 静态 成 员 , 尤 其 是 只 读 ( 使 用 readonly 关键 字 修 饰 ) 
字段 。 
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实例 58 ”验证 属性 值 的 有 效 性 


【导语 】 
属性 的 声明 有 一 种 简练 的 语法 ,例如 : 


public int NewValue { get; set; } 
要 把 属性 声明 为 只 读 模式 ,可 以 按 以 下 格式 去 掉 set 语句 。 
public int NewValue { get; } 


这 种 语法 优点 是 简练 明了 ,但 有 些 时 候 并 不 太 适 用 ,最 典型 的 情况 就 是 代码 对 属性 值 进 
行 验证 。 这 种 情况 就 需要 显 式 地 声明 一 个 私有 字段 来 保存 属性 值 (简练 语法 在 编译 时 会 由 
编译 器 自动 生成 存储 属性 值 的 字段 ) ,并 在 属性 的 set 访问 器 中 对 属性 的 赋值 进行 检查 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 User 类 ,其 中 包含 两 个 string 类 型 的 属性 ,并 且 在 为 属性 赋值 时 需要 
验证 字符 串 的 长 度 。 如 果 字 符 串 的 长 度 不 符合 要 求 ,代码 会 抛 出 异常 , 详 见 代 码 清 单 4-2。 

代码 清单 4-2 User 类 


class User 
{ 
string _userName; 
public string Username 
{ 
get { return _userName; } 
set 
{ 
if(value. Length > 15) 
throw new ArgumentException(" 用 户 名 长 度 不 能 超过 15 个 字符 "); 
. 


_userName = value; 
} 


string _password; 
public string Password 
{ 
get { return _password; } 
set 
{ 
if(value. Length < 8) 
{ 
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throw new ArgumentException( "密码 长 度 至 少 要 8 位 "); 
} 


_password = value; 


| 


value 是 一 个 语言 关键 字 , 它 是 一 个 特殊 的 临时 变量 ,用 来 存放 属性 的 赋值 。 

Username 属性 的 值 最 终 由 _userName 字段 来 存储 ,Password 属性 的 值 由 _password 
字段 来 存储 。 在 set 访问 器 中 保存 属性 值 之 前 进行 检查 ,如 果 符 合 要 求 就 把 value 变量 的 值 
赋 给 用 来 存放 属性 值 的 字段 。 

步骤 3: 回 到 项 目 模板 生成 的 Main 方法 ,实例 化 一 个 User 对 象 。 


User u = new User(); 
步骤 4: 尝试 对 User 实例 的 属性 赋值 。 


try 
{ 
u, Username = "Tom"; 
U.Password = " 关 关 关 关 关头 
上 
catch(Exception ex) 
{ 
Console. WriteLine( $ "错误 :{ex. Message} 。"); 
} 


因为 向 属性 赋值 的 过 程 中 可 能 会 出 现 异常 ,所 以 把 赋 
值 的 代码 写 在 try 语句 块 中 ,并 在 catch 子 语句 中 捕捉 可 能 
发 生 的 异常 。 

步骤 5: 运行 项 目 , 由 于 为 Password 属性 所 赋值 的 长 
度 小 于 8, 在 对 属性 值 验证 时 会 发 生 异 常 ,所 以 输出 如 


图 4-3 所 示 的 内 容 。 图 4-3 属性 值 未 通过 验证 
实例 59 初始 化 只 读 字段 
【导语 】 


只 读 字 段 与 常量 不 同 , 常 量 必 须 在 声明 时 赋值 ,而 且 不 能 使 用 表达 式 的 运算 结果 赋值 
(例如 ,不 能 把 某 个 变量 的 值 赋 给 常量 ) ,但 只 读 字段 是 可 以 使 用 其 他 表达 式 的 运算 结果 来 赋 
值 的 。 只 读 字段 和 常量 有 一 个 共同 点 一 一 初始 化 之 后 不 能 在 代码 中 修改 。 

初始 化 只 读 字段 有 两 种 方法 : 第 一 种 是 在 声明 之 后 立即 赋值 ; 第 二 种 是 先 声明 字段 ， 
然后 在 类 构造 函数 中 赋值 。 
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【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 类 ,并 添加 一 个 只 读 字段 。 
class SomeType 

{ 


public readonly string GenericKey; 
. 


步骤 3: 在 类 构造 函数 中 为 只 读 字段 赋值 ,并 且 所 赋 的 值 来 自传 递 给 构造 函数 的 参数 。 


class SomeType 
{ 
public readonly string GenericKey; 


public SomeTYpe( string key) 
{ 
GenericKey = key; 
} 
L 


步骤 4: 在 Main 方法 中 实例 化 上 述 类 。 

SomeType s = new SomeType("000— 862—2—1515"); 

步骤 5: 此 时 ,如 果 试 图 修改 GenericKey 字段 就 会 发 生 错 误 , 因 为 它 是 只 读 的 。 
s. GenericKey = "355—15414"; 

步骤 6: 虽然 不 能 修改 ,但 允许 读 取 。 


Console. WriteLine(s. GenericKey); 


实例 60 重 载 方法 


【导语 】 

重 载 方法 是 指名 称 相同 ,但 参数 的 数据 类 型 或 个 数 不 相 同 的 一 组 方法 。 以 下 情形 可 以 
构成 重 载 : 

(1) 参数 个 数 相同 ,但 类 型 不 同 。 例 如 : 

public void Play(int x) { } 

public void Play(float x) { } 
以 上 两 个 Play 方法 ,都 有 一 个 x 参数 ,但 其 中 一 个 是 int 类 型 , 另 一 个 是 float 类 型 。 由 了 
数 类 型 不 同 ,上 述 两 个 方法 可 以 构成 重 载 。 

(2) 参数 个 数 不 同 ,例如 : 


Ww 
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void WorkAs( string args, int times) { } 
void WorkAs(string args) { } 
void WorkAs() { } 
上 述 三 个 方法 ,参数 个 数 分 别 为 3 个 .1 个 和 0 个 ,可 以 构成 重 载 。 
但 是 仅 赁 返回 值 类 型 的 差异 是 无 法 构成 重 载 的 。 例 如 : 
byte[ ] GetData( int start，int end) { } 
long GetData( int start, int end) { } 
上 述 两 个 方法 参数 个 数 和 类 型 都 相同 ,虽然 返回 值 类 型 不 同 ,但 是 它们 无 法 构成 重 载 ,因为 
编译 器 无 法 根据 返回 类 型 来 判定 调用 哪个 重 载 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 在 项 目 模板 生成 的 默认 命名 空间 中 定义 一 个 Test 类 。 


class Test 


{ 


} 
步骤 3: 在 类 中 定义 三 个 重 载 的 Compute 方法 。 


class Test 

{ 
public int Compute( int a) 
{ 


returna * 1; 


} 


public int Compute( int a, int b) 
{ 
returna * b; 


} 


public int Computel( int a, int b, int c) 
{ 
returna * bx oe; 
} 
} 


带 一 个 参数 的 版 本 会 将 参数 乘 以 1 后 返回 ; 带 两 个 参数 的 版 本 会 将 两 个 参数 相 乘 后 返 
回 ; 带 三 个 参数 的 版 本 会 将 三 个 参数 相 乘 后 返回 。 
步骤 4: 回 到 Main 方法 ,尝试 调用 以 上 三 个 重 载 的 Compute 方法 。 


Test t = new Test(); 
int rl = t.Compute(5); 
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int r2 t. Compute(5, 5); 
int r3 = t.Compute(5, 5, 5); 


Console. WriteLine(" 三 个 计算 结果 分 别 为 :{0}, {1}, {2}", rl, r2, r3); 


步骤 5: 项 目 运 行 后 ,输出 以 下 结果 : 


三 个 计算 结果 分 别 为 :5, 25, 125 


实例 61 类 实例 传递 给 方法 后 为 什么 没有 被 更 改 
【导语 】 

先 来 看 一 段 让 许多 初学 者 疑惑 的 代码 。 

首先 声明 一 个 Product 类 ,用 于 做 测试 。 


class Product 
{ 
public string Name { get; set; } 
public int Code { get; set; } 
} 
然后 定义 一 个 Update 方法 ,参数 是 一 个 Product 对 象 ,在 方法 内 部 ,让 参数 变量 引用 一 
个 新 的 Product 实例 。 


void Update(Product p) 


Name = "测试 产品 C"， 
Code = 700021 
}; 
F 


实例 化 一 个 Product 对 象 。 


Product pro = new Product(); 
pro. Name = "测试 产品 A"; 
pro. Code = 60009; 


调用 Update 方法 ,并 传递 上 面 的 实例 。 

Update( pro); 

此 时 读者 一 定 会 认为 ,pro 变量 所 引用 的 应 该 是 Update 方法 中 创建 的 新 实例 , 即 Name 
属性 为 “测试 产品 C”。 而 实际 上 ,pro 变量 的 Name 属性 依然 是 “测试 产品 A”,Code 属性 依 
然 是 60009 。 

这 样 就 出 现 疑惑 了 ,既然 类 是 引用 类 型 , 那 为 什么 调用 Update 方法 后 ,变量 pro 所 引用 
的 仍然 是 原来 的 Product 实例 呢 ? 这 是 因为 : 变量 本 身 是 存储 在 栈 内 存 中 的 , 当 把 变量 pro 
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传递 给 Update 方法 时 ,变量 pro 是 把 自身 复制 了 一 份 交 给 方法 的 p 参数 。 如 果 在 Update 
方法 中 没有 让 p 参数 引用 新 的 Product 实例 ,而 只 是 修改 了 p 参数 所 引用 的 实例 属性 ,那么 
当 Update 方法 返回 后 ,pro 变量 和 p 参数 中 所 存储 的 引用 地 址 相同 ,因此 ,方法 内 部 所 作 的 
修改 在 方法 外 部 会 生效 。 然 而 ,前 面 的 实例 代码 是 在 Update 方法 中 让 p 参数 引用 了 一 个 
新 的 Product 实例 ,如 此 一 来 ,pro 变量 和 op 参数 中 所 存储 的 引用 就 不 是 同一 个 地 址 了 , 即 它 
们 引用 了 不 同 的 Product 实例 。 所 以 在 调用 Update 方法 之 后 ,再 去 访问 pro 变量 ,实际 上 
访问 的 还 是 旧 的 Product 实例 ,而 非 新 创建 的 实例 。 这 就 使 得 Update 方法 内 部 所 做 的 修改 
在 方法 外 部 无 效 。 

本 实例 将 演示 如 何 解 决 这 个 问题 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Product 类 。 

class Product 

public string Name { get; set; } 

public int Code { get; set; } 
} 


步骤 3: 在 Program 类 中 定义 Update 方 法。 


static void Update(ref Product p) 
{ 

p = new Product 

{ 


Name = “测试 产品 C"， 
Code = 700021 
}; 


注意 : 在 定义 方法 参数 的 时 候 要 加 上 ref 关键 字 , 这 样 变量 在 传递 给 方法 时 ,就 会 将 自身 作 
为 引用 来 传递 ,而 不 是 复制 自身 。 


步骤 4: 在 Main 方法 中 实例 化 一 个 Product 对 象 。 


Product pro = new Product 
{ 
Name =“" 测 试 产品 A"， 
Code = 60009 
}; 


步骤 5: 为 了 便于 对 比 ,在 调用 Update 方法 前 ,先进 行 一 次 屏幕 输出 。 


Console. WriteLine( $ "调用 Update 方法 前 。\nName = {pro. Name},Code = {pro.Code}\n\n"); 
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步骤 6: 调用 Update 方法 ,并 传递 变量 。 
Update( ref pro); 


步骤 7: 在 调用 Update 方法 后 ,再 进行 一 次 屏幕 
输出 。 


= 60009 


Console. WriteLine( $ "调用 Update 方法 后 。\nName = 出 斌 产品 C，Code = 700021 

{pro. Name}, Code = {pro.Code}"); 

步骤 8: 按 下 快捷 键 F5 运行 项 目 ,图 4-4 可 以 对 
比 Update 调用 方法 前 后 的 输出 。 


图 4-4 Update 方法 调用 前 后 对 比 


注意 : 在 调用 带 有 ref 关键 字 的 方法 时 ,也 要 使 用 ref 关键 字 。 


实例 62 输出 参数 


【导语 】 

在 声明 方法 的 输出 参数 的 时 候 需 要 加 上 out 关键 字 , 在 调用 的 时 候 也 需要 加 上 out 关 
键 字 。 要 接收 方法 输出 的 参数 值 ,必须 在 方法 外 部 定义 一 个 变量 。 假 设 Run 方法 有 一 个 布 
尔 类 型 的 输出 参数 ,调用 方法 如 下 : 

bool outResult; 

Run ( out outResult ); 

其 中 ,outResult 变量 用 于 接收 输出 参数 。 为 了 提升 编写 代码 的 效率 ,还 可 以 把 上 面 的 写法 
合并 成 以 下 语句 。 


Run ( out bool outResult ); 


【操作 流程 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 在 Program 类 中 定义 一 个 带 输出 参数 的 方法 。 
static void Work(double x, double y, out double result) 
{ 
result = x + y; 
} 
result 是 输出 参数 ,声明 时 要 加 上 out 关键 字 。 
步骤 3: 在 Main 方法 中 进行 调用 。 
double r; 
Work(2. 001d, 0.855d, out r); 


还 可 以 这 样 调用 。 


86 十 .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


Work(2. 001d, 0.885d, out double r); 

步骤 4: 输出 调用 结果 。 

Console. WriteLine(" 计 算 结 果 :{0}",r); 

步骤 5: 运行 后 ,控制 台 窗 口 输出 以 下 信息 。 


计算 结果 :2.886 


注意 : 输出 参数 的 功能 与 返回 值 有 些 类 似 , 而 且 也 可 以 在 一 个 方法 中 同时 使 用 返回 值 和 输 
出 参数 。 但 是 返回 值 只 能 是 一 个 单一 对 象 , 如 果 需 要 方法 返回 不 同 数据 类 型 的 结果 ， 
就 应 当 使 用 输出 参数 ,因为 一 个 方法 可 以 定义 多 个 输出 参数 ,但 不 能 定义 多 个 返 
回 值 。 


实例 63 ”可 变 个 数 的 方法 参数 


【导语 】 
在 声明 方法 参数 时 ,可 以 使 用 数组 类 型 的 参数 ,并 且 在 前 面 加 上 params 关键 字 。 这 表 
明 在 调用 方法 时 ,可 以 直接 输入 要 传递 给 数组 参数 的 值 ( 即 直 接 传 数组 元 素 ) ,每 个 元 素 之 间 
用 英文 的 逗号 隔 开 ,与 传递 普通 参数 一 样 。 
由 于 params 关键 字 所 修饰 的 参数 是 数组 类 型 ,所 以 参数 个 数 是 可 变 的 ,也 可 以 是 0 个 。 
为 了 让 编译 器 能 够 识别 可 变 个 数 的 参数 ,一 个 方法 中 只 能 使 有 一 次 用 params 关键 字 修饰 的 
参数 ,而且 该 参数 必须 位 于 方法 参数 列表 的 最 后 ,其 后 面 不 能 出 现 其 他 参数 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 在 生成 的 Program 类 中 定义 一 个 方法 。 
static void Sample(params int[ ] numbers) 
{ 
Console. WriteLine("\n 参数 列表 :"); 
foreach( int i in numbers) 
{ 
Console. Write("{0}", i); 
} 
} 


该 方法 只 有 一 个 参数 ,类 型 是 int 数组 ,并 且 带 有 params 关键 字 , 说 明 它 是 一 个 可 变 个 
数 的 参数 。 
步骤 3: 在 Main 方法 中 测试 对 上 述 方法 的 调用 。 


Sample(1, 2, 3, 4, 5); 
Sample(9, 8); 
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第 一 次 调用 传递 了 5 个 参数 ,第 二 次 调用 传递 了 2 个 参数 。 


注意 : 传递 参数 时 ,一 定 要 使 用 类 型 匹配 的 值 。 例 如 上 面 的 Sample 方法 ,需要 的 参数 均 为 
int 类 型 ,调用 时 就 不 能 给 参数 传递 string 类 型 的 实例 。 
步骤 4: 运行 应 用 程序 ,两 次 调用 Sample 方法 所 输出 的 内 
容 如 图 4-5 所 示 。 


实例 64 ”使 用 按 引 用 传递 的 返回 值 


【导语 】 

除了 可 以 使 用 按 引用 传递 的 输入 参数 外 ,还 可 以 使 用 按 引 ”图 4-5 调用 带 可 变 个 
用 传递 的 返回 值 。 与 按 引用 传递 的 输入 参数 相似 , 按 引 用 传递 数 参 数 的 方法 
的 返回 值 也 使 用 ref 关键 字 。 例 如 以 下 方法 就 可 以 按 引 用 传递 
返回 的 数据 。 


ref string GetName ( int index ); 


调用 上 述 方法 时 ,需要 一 个 按 引用 赋值 的 变量 来 获取 返回 的 内 容 , 为 了 让 这 个 变量 能 够 
按 引 用 赋值 ,在 声明 的 时 候 也 要 加 上 ref 关键 字 。 如 以 下 代码 所 示 。 


ref string resStr = ref GetName ( 1 ); 


如 果 变 量 是 按 引用 赋值 ,那么 当代 码 修改 变量 所 指向 的 对 象 时 ,变量 所 引用 的 内 容 也 会 
同步 被 修改 。 

当 要 返回 的 对 象 包含 比较 复杂 的 数据 时 (尤其 是 结构 , 它 会 自我 复制 ), 可 以 将 其 按 引 用 
方式 返回 ,以 节省 对 象 数 据 在 复制 过 程 中 的 性 能 开销 。 使 用 按 引用 传递 的 返回 值 时 ,需要 注 
意 以 下 几 点 : 

(1) 当 方法 (或 属性 ) 要 按 引用 返回 时 ,必须 有 一 个 变量 来 存放 对 象 引 用 ,并 且 该 变量 的 
生命 周期 必须 大 于 该 方法 (属性 )。 也 就 是 说 ,在 方法 (属性 ) 内 部 声明 的 变量 是 不 能 按 引用 
返回 的 ,因为 当 方 法 (属性 ) 返 回 后 变量 的 生命 周期 就 结束 了 ,所 以 这 个 变量 应 当 是 类 (或 结 
构 ) 级 别 的 字段 (一 般 是 私有 字段 )。 

(2) 不 能 直接 返回 null, 和 否则 会 发 生 错 误 。 因 为 该 值 无 任何 引用 ,无 法 进行 传递 。 但 是 
用 来 存放 引用 的 变量 是 可 以 为 null 的 ,例如 类 级 别 的 一 个 字段 可 以 赋 null 值 , 当 该 字段 被 
作为 按 引 用 传递 的 返回 值 时 不 会 发 生 错误 。 

(3) 使 用 ref 关键 字 声 明 的 变量 ,可 以 引用 单个 对 象 实例 ,也 可 以 引用 数组 中 的 某 个 元 
素 , 但 不 能 引用 List< T > 对 象 中 的 元 素 。List< T > 对 象 不 是 直接 访问 元 素 实 例 , 它 内 部 有 
封装 和 传递 变量 的 过 程 , 而 由 于 数组 是 可 以 直接 引用 元 素 实 例 的 ,因此 数组 中 的 元 素 可 以 被 
ref 关键 字 声 明 的 变量 引用 。 

为 了 更 好 地 对 比 普通 返回 值 与 按 引 用 传递 的 返回 值 之 间 的 不 同 ,本 实例 声明 了 两 个 基 
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本 相同 的 类 ,类 中 都 封装 一 个 int 类 型 的 私有 字段 ,并 通过 Value 属性 公开 该 字段 的 值 。 而 


这 两 个 类 的 差异 就 在 于 Value 属性 的 返回 方式 ,一 个 是 普通 的 按 值 返回 , 另 一 个 则 是 按 引用 
返回 。 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 两 个 类 一 一 Testl 和 Test2。 详 见 代 码 清单 4-3。 
代码 清单 4-3 ”Testl 类 与 Test2 类 


class Test1 


{ 


private int local; 


public Testl(int init) 
{ 
_local = init; 


} 


public void DisplayValue() 
{ 


Console. WriteLine( $ "当前 值 :{_local}"); 


} 


public int Value => _local; 


class Test2 


{ 


private int _local; 


public Test2(int init) 
{ 
_local = init; 


} 


public void DisplayValue() 
{ 


Console. WriteLine( $ "当前 值 :{_local}"); 


} 


public ref int Value => ref _local; 


3. 


当 使 用 ref 关键 字 声 明了 方法 (或 


属性 ) 后 ,在 返回 内 部 代码 时 也 要 加 上 ref 关键 字 。 


步骤 3: 在 Main 方法 中 ,分 别 对 这 两 个 类 进行 测试 ,如 代码 清单 4-4 所 示 。 


第 4 


代码 清单 4-4 对 比 按 值 返回 与 按 引 用 返回 


WriteLine(" ——————— 不 使 用 按 引用 传递 的 返回 值 ------- "); 
Testl tl = new Test1(100); 

WriteLine(" 初 始 值 :"); 

t1. DisplayValue(); 

int x = t1.Value; 

x = 200; 

WriteLine( "修改 属性 返回 值 之 后 :"); 

t1.DisplayValue( ); 


WriteLine("\n ——————— 使 用 按 引用 传递 的 返回 值 ------- "); 
Test2 t2 = new Test2(100); 

WriteLine(" 初 始 值 :"); 

t2.DisplayValue( ); 

ref int y = ref t2.Value; 

Y= 200; 

WriteLine(" 修 改 属性 返回 值 之 后 :"); 

t2.DisplayValue(); 


步骤 4: 运行 项 目 , 输 出 结果 如 图 4-6 所 示 。 


4-6 两 种 返回 方式 的 输出 结果 
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当 返 回 值 是 按 值 传递 时 ,会 复制 一 份 _local 变量 所 指向 的 实例 ,然后 返回 新 实例 ,修改 
Value 属性 所 返回 的 值 时 ,实际 上 修改 的 是 复制 后 的 实例 ,因此 _local 字段 的 值 仍然 是 100。 
当 返 回 值 是 按 引用 传递 时 ,就 相当 于 为 _local 字段 创建 一 “别名 ”, 由 于 Value 属性 返回 


的 是 引用 ,因此 当 返 回 的 值 被 修改 后 ,_local 字段 的 值 也 同步 被 修改 。 


实例 65” 按 参数 名 称 来 传 值 


【导语 】 
假设 有 如 下 方法 。 


int Add ( int a, intb ) 


- 般 情 况 下 ,在 调用 方法 时 都 是 将 参数 按照 其 定义 的 顺序 进行 传递 ,例如 : 
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int x = Add (1, 2); 


这 时 候 ,数值 1 会 自动 传递 给 a 参数 ,数值 2 会 自动 传递 给 参数 b。 
但 是 如 果 和 希望 把 2 传递 参数 a, 把 1 传 给 参数 b, 当 然 最 简单 的 方法 是 把 位 置 调换 一 下 。 


Add(2, 1); 


还 有 一 种 方法 ,就 是 按 参 数 的 命名 来 传递 , 即 在 传递 参数 时 明确 指定 参数 的 名 字 , 上 面 
代码 也 可 以 写成 如 下 形式 。 


Rdd (a:2, b:1); 
或 
Rdd (b:1, a:2); 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 本 例 以 调用 Math 类 的 Min 方法 为 例 。 首 先 通过 常规 调用 方法 ,直接 按 参 数 声 
明 的 顺序 传递 即 可 。 


int x = Math.Min(5, 13); 
步骤 3: 也 可 以 通过 参数 名 称 来 显 式 指定 参数 值 。 


int y = Math.Min(vall: 2, val2: 6); 
// 或 者 
int z = Math.Min(val2: 17, vall: 58); 


参数 名 称 与 参数 值 之 间 ,用 一 个 半角 冒号 来 分 隔 。 
实例 66 ”可 选 参数 
【导语 】 
在 定义 参数 的 同时 分 配 一 个 默认 值 ,该 参数 就 成 为 可 选 参数 。 可 选 参 数 在 调用 时 可 以 
明确 赋值 ,也 可 以 忽略 。 如 果 可 选 参数 在 调用 时 被 忽略 , 则 保留 其 默认 分 配 的 值 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 一 个 带 有 两 个 可 选 参数 的 方法 。 
static void Something( int pl, byte p2 = 255，bool p3 = false) 
{ 
string msg = "参数 列表 \n" + 
$ "{nameof(p1)} = {pil}\n{nameof(p2)} = {p2}\n{nameof(p3)} = {p3}\n"; 


Console. WriteLine(msg); 


} 
其 中 ,pl 是 必须 参数 ,在 调用 时 必须 赋值 ,p2 和 p3 是 可 选 参数 ,在 调用 时 可 以 忽略 。 
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接 下 来 将 进行 调用 演示 。 

步骤 3: 调用 上 述 方法 ,并 为 所 有 参数 赋值 。 

Something(20, 100, true); 

步骤 4: 只 为 第 一 个 可 选 参数 赋值 。 

Something(31, 1); 

此 时 ,pl 参数 的 值 为 31,p2 是 可 选 参数 ,默认 分 配 的 值 为 255， 
由 于 此 处 明确 赋值 ,所 以 p2 的 值 变 为 1,p3 参数 也 是 可 选 参数 , 仍 保 
持 默认 值 false。 

步骤 5: 只 为 二 个 可 选 参数 赋值 , 即 pl 和 p3 两 个 参数 ,p2 参数 
被 忽略 。 

Something(p1: 65, p3: true); 

由 于 第 二 个 参数 被 忽略 ,因此 这 里 要 通过 参数 的 名 称 赋值 ,以 下 
调用 的 语法 错误 。 


Something(900, , true); 


步骤 6: 按 F5 快捷 键 运 行 项 目 ,输出 结果 如 图 4-7 所 示 。 
实例 67 ”在 声明 时 初始 化 属性 


【导语 】 
属性 可 以 使 用 以 下 简化 的 代码 来 声明 。 


图 4-7 调用 可 选 参数 


public string Code { get; set; } 
如 果 需 要 ,可 以 在 声明 后 立刻 对 属性 进行 初始 化 ,例如 以 下 代码 。 
public string Code { get; set; } = "C— 000"; 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 类 ,此 类 包含 三 个 公共 属性 ,并 在 声明 属性 时 进行 初始 化 。 


class Student 
{ 
public long ID { get; set; } = 0L; 
public string Name { get; set; } = "新 学 员 "; 
public string Course { get; set; } = "Visual Basic"; 
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注意 ; 因为 对 属性 初始 化 时 使 用 的 是 赋值 语句 ,所 以 后 面 要 写 上 半角 分 号 ,表示 代码 行 
结束 。 


步骤 3: 使 用 上 面 定义 的 类 实例 化 一 个 对 象 ,实例 化 之 后 不 对 属性 赋值 ,而 是 直接 输出 
到 屏幕 上 。 

Student stu = new Student(); 

WriteLine(" 学 员 编 号 :{0}\n 学 员 姓 名 : {1}\n 学习 课 程 :{2}"，stu. 

ID，stu. Name，stu,. Course) ; 

步骤 4: 运行 应 用 程序 项 目 , 就 能 看 到 各 个 属性 的 默认 值 输 
出 到 屏幕 上 了 ,如 图 4-8 所 示 。 


4-8 属性 的 默认 值 


4.2 委托 与 事件 
实例 68 ”委托 实例 如 何 绑 定 方法 
【导语 】 


委托 是 一 种 数据 类 型 (属于 引用 类 型 ) , 它 的 声明 类 似 于 方法 ,但 委托 不 包含 任何 方法 的 
实现 代码 ,因此 在 调用 委托 实例 前 必须 绑 定 方法 。 单 播 委托 只 能 绑 定 一 个 方法 ,多 播 委托 则 
可 以 绑 定 多 个 方法 。 当 委托 实例 被 调用 时 ,与 之 绑 定 的 所 有 方法 都 会 被 调用 。 

某 个 方法 实例 必须 参数 类 型 .参数 个 数 .参数 顺序 以 及 返回 类 型 都 与 对 应 的 委托 相 匹 配 
时 ,才能 绑 定 在 委托 实例 。 例 如 ,以 下 委托 接受 一 个 string 类 型 的 参数 ,并 且 返 回 类 型 
为 int。 


delegate int Test(string str) 7 
以 下 方法 不 能 与 Test 委托 实例 绑 定 。 
int Save ( byte[ ] buffer ) 


虽然 该 方法 返回 int 类 型 的 值 , 但 是 它 的 参数 类 型 是 字 节 数组 ,并 非 字 符 串 类 型 ,因此 
不 能 与 Test 委托 实例 绑 定 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 委托 ,输入 参数 有 两 个 ,一 个 是 int 类 ,一 个 是 double 类 型 ,返回 值 为 
double 类 型 。 


delegate double DoSomething( int x, double y); 


委托 属于 数据 类 型 ,因此 可 以 直接 在 命名 空间 下 声明 ,并 使 用 delegate 关键 字 。 
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步骤 3: 在 项 目 模板 生成 的 Program 类 中 定义 一 个 静态 方法 ,用 于 与 上 面 所 定义 的 委 
托 进行 绑 定 。 


static double RunHere( int a, double b) 
{ 


returna + b; 


} 

无 论 是 静态 方法 还 是 实例 方法 ,只 要 是 可 访问 的 或 者 参数 与 返回 值 匹配 的 ,都 可 以 与 委 
托 实 例 进行 绑 定 。 

步骤 4: 实例 化 DoSomething 委托 。 


DoSomething dele = new DoSomething(RunHere) ; 


委托 对 象 实例 化 时 也 是 使 用 new 运算 符 , 并 且 把 要 绑 定 的 方法 的 名 字 传 递 给 构造 郴 
数 。 委 托 实例 化 还 可 以 用 简化 的 语法 一 一 直接 把 方法 的 名 字 赋 值 给 委托 变量 。 


DoSomething dele = RunHere; 
步骤 5: 委托 实例 的 调用 方式 与 方法 的 调用 一 样 ,可 以 传 参数 ,也 可 以 接收 返回 值 。 


double res = dele(16, 27.67d); 


实例 69” 绑 定 多 个 方法 


【导语 】 

多 播 委托 允许 委托 实例 绑 定 多 个 方法 ,其 基础 类 型 为 MulticastDelegate, 但 是 在 实际 编 
写 代码 时 是 无 须 考虑 该 基 类 的 。 在 代码 中 ,可 以 使 用 * 十 ”运算 符 ( 加 号 ) 添 加 要 绑 定 的 方法 ， 
或 者 使 用 "一 "运算 符 ( 减 号 ) 移 除 已 绑 定 的 方法 。 

在 多 播 委托 实例 上 添加 或 移 除 方法 实例 ,使 用 更 多 的 是 “十 二” 与 一 二 "运算 符 。 假 设 
某 委托 实例 变量 名 为 dx, M1 和 M2 是 方法 ,要 让 dx 委托 绑 定 这 两 个 方法 ,可 以 写 为 如 下 
形式 。 

dx = Ml; 

dx += M2; 

完整 的 写法 如 下 。 


d= d+ M2; 


因为 多 个 方法 实例 合并 后 会 产生 新 的 委托 实例 ,使 用 “十 二 "运算 符 让 委托 实例 与 新 绑 
定 的 方法 组 合 后 产生 的 新 实例 又 赋值 给 dx 变量 ,这 样 就 可 以 使 用 dx 变量 调用 组 合 后 的 委 
托 实例 。 
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【操作 流程 
步骤 1: 新建 控 制 台 应 用 程序 项 目 。 
步骤 2: 定义 一 个 委托 类 型 。 


delegate void MyFunction(); 
步骤 3: 在 Program 类 中 定义 两 个 静态 方法 。 


static void Output1() 
{ 
Console. NriteLine(" 这 是 第 一 个 方法 "); 
上 
static void Output2() 


{ 
Console. WriteLine(" 这 是 第 二 个 方法 "); 
} 


步骤 4: 在 Main 方法 中 ,用 上 面 定 义 的 委托 声明 一 个 变量 ,初始 化 为 null。 
MyFunction del = null; 


步骤 5: 让 委托 变量 绑 定 Outputl 和 Output2 方法 。 


del += Outputl; FE 


del += Output2; - 区 
del(); 


图 4-9 委托 会 同时 调用 


步骤 7: 运行 应 用 程序 项 目 , 当 委托 实例 被 调用 ,关联 的 两 个 绑 定 的 所 有 方法 


方法 也 会 被 调用 ,如 图 4-9 所 示 。 
实例 70 匿名 方法 


【导语 】 
匿名 方法 使 用 delegate 关键 字 作 为 方法 名 ,后 接 方法 参数 列表 以 及 方法 体 。 匿 名 方法 
可 以 做 到 在 不 定义 新 方法 的 前 提 下 直接 给 委托 变量 赋值 。 某 个 委托 类 型 的 声明 如 下 。 


delegate int DoSomething ( int a, int b ); 
在 声明 委托 变量 后 ,可 以 用 匿名 方法 直接 赋值 ,而 不 需要 定义 新 的 方法 来 绑 定 。 


DoSomething d = delegate ( int j，intk ) 
{ 
returnj + k; 


}; 
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【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 一 个 委托 ,委托 返回 void 类 型 ,接受 两 个 double 类 型 的 参数 。 


delegate void Test(double f, double g); 

步骤 3: 在 Main 方法 中 ,声明 一 个 委托 变量 ,初始 化 为 null。 
Test td = null; 

步骤 4: 让 委托 变量 绑 定 三 个 匿名 方法 。 

td += delegate (double x, double y) 

Console. WriteLine( $ "{x} + {y} = {x + y}"); 

站 += delegate (double x, double y) 

Console. WriteLine( $ "{x} — {y} = {x — y}"); 

a += delegate (double x, double y) 


Console. WriteLine( $ "{x} x {y} = {x * y}"); 


; 


步骤 5: 调用 委托 。 

td(0.3d, 0.2d); ! 

步骤 6: 运行 应 用 程序 项 目 , 当 委托 实例 被 调用 ,三 个 关联 的 ”图 4-10 调用 匿名 方法 
匿名 方法 就 会 被 调用 ,运行 结果 如 图 4-10 所 示 。 


注意 ; 如 果 绑 定 的 方法 需要 在 代码 中 多 次 引用 ,就 不 能 使 用 匿名 方法 了 ,因为 匿名 方法 没有 
名 称 , 声 明之 后 在 代码 中 无 法 再 次 引用 。 


实例 71 封装 事件 

【导语 】 

事件 是 类 型 中 的 一 种 成 员 对 象 , 它 是 委托 类 型 。 主 要 是 运用 了 委托 可 以 绑 定 一 个 或 多 
个 方法 的 特点 , 当 作为 事件 的 委托 被 调用 时 ,就 能 连带 地 调用 其 绑 定 的 方法 。 这 样 一 来 ,类 
型 中 的 代码 只 负责 引发 (调用 ) 事 件 ,而 不 需要 考虑 如 何 响应 事件 。 

声明 事件 需要 使 用 event 关键 字 , 例 如 下 面 委托 将 作为 某 个 类 的 事件 类 型 。 


public delegate void TestEventDelegate(object obj, int arg); 


在 类 中 ,可 以 用 以 上 委托 来 定义 事件 。 
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public event TestEventDelegate Play; 


事件 一 般 应 该 声明 为 公共 成 员 ,这 样 才能 方便 外 部 代码 引用 ,以 绑 定 响应 事件 的 方法 。 
假设 变量 vt 是 某 个 类 的 实例 ,可 以 把 它 的 Play 事件 与 方法 绑 定 。 
tn.Play += delegate (object o，int a) 


{ 
Console. WriteLine(a); 


}; 
只 要 Play 事件 在 类 中 被 调用 ,与 其 绑 定 的 方法 也 会 被 调用 ,这 样 就 达到 了 “ 当 某 件 事情 


发 生 时 ,代码 会 做 出 响应 ”的 效果 。 就 像 上 面 代码 所 演示 的 ,Play 事件 绑 定 了 一 个 匿名 方 
法 ,在 匿名 方法 中 通过 WriteLine 方法 输出 事件 参数 的 值 。 绑 定 方法 后 ,一 旦 Play 事件 被 
调用 ,那么 屏幕 上 就 会 立即 输出 事件 参数 的 值 。 


上 面 所 举例 的 事件 定义 是 直接 公开 事件 委托 的 ,在 某 些 特殊 情况 下 ,也 可 以 像 属性 那 


样 ,把 事件 所 使 用 的 委托 进行 封装 , 即 类 型 的 内 部 用 一 个 私有 字段 来 存储 委托 实例 ,然后 将 
event 关键 字 所 定义 的 事件 对 外 公开 ,但 字段 本 身 不 对 外 公开 。 这 种 封装 一 般 用 在 需要 对 
赋值 给 委托 的 方法 实例 进行 验证 的 场合 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 一 个 委托 ,用 来 作为 事件 类 型 。 


public delegate void DemoEventDelegate(object obj, int count); 
步骤 3: 声明 一 个 测试 类 ,并 包含 事件 成 员 。 


public class Test 


{ 
DemoEventDelegate myEvent; 


public event DemoEventDelegate Worked 
{ 
add 
_myEvent += value; 
} 
remove 


4. 
_myEvent 一 = value; 


} 


2 
以 上 代码 中 ,通过 一 个 _myEvent 私有 字段 来 保存 事件 ,对 外 公开 的 事件 是 Worked。 


属性 类 似 , 属 性 通常 用 get 和 set 访问 器 ,而 事件 也 有 两 个 访问 器 一 一 add 访问 器 用 于 向 
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作为 事件 的 委托 添加 要 绑 定 的 方法 实例 ; remove 访问 器 用 于 从 作为 事件 的 委托 实例 中 移 除 某 
个 方法 实例 。value 是 一 个 关键 字 , 表 示 赋 值 给 委托 的 值 ,作用 与 属性 中 的 value 关键 字 相 同 。 
步骤 4: 这 种 封装 常用 于 验证 ,例如 在 add 的 时 候 , 可 以 检查 值 是 否 为 null。 


add 
{ 


if(value != null) 
{ 
_myEvent += value; 

} 
} 
步骤 5: 在 类 中 ,需要 用 代码 来 调用 事件 委托 ,这 样 才能 引发 事件 ,此 处 定义 一 个 公开 的 

Run 方法 , 当 方 法 被 调用 时 ,会 调用 事件 委托 ,然后 也 会 调用 与 委托 绑 定 的 所 有 方法 。 

Private intc = 0; 
public void Run() 
{ 


_myEvent?. Invoke(this, ++c); 


} 

每 次 调用 都 会 先 让 c 字段 的 值 加 上 1 再 传递 处 理事 件 的 方法 。 上 面 代码 在 调用 委托 
时 ,在 变量 名 后 面 加 了 一 个 “?”( 英 文 的 问号 ) ,主要 是 用 来 检查 _myEvent 字段 是 否 为 null， 
如 果 为 null 就 不 调用 了 。 运 算 符 “?? 可 以 简化 代码 , 它 相当 于 如 下 代码 。 

if(_myEvent != null) 

{ 

_myEvent(this, ++c); 

} 

步骤 6: 实例 化 用 于 测试 的 类 。 

Test t = new Test(); 

步骤 7: 为 Worked 事件 绑 定 处 理 代码 ,此 处 使 用 了 Lambda 表达 式 。 

t. Worked += (k, f) => Console.WriteLine( $ "你 已 调用 了 {f} 次 实例 。"); 

当 Worked 事件 发 生 时 会 在 屏幕 上 输出 一 行文 本 。 

步骤 8: 为 了 验证 事件 是 否 会 发 生 , 可 以 连续 调用 4 次 Run 方法。 


七 .Run( ) 7 
七 .Run( ) 
t. Run(); 
t. Run(); 


步骤 9: 实例 运行 后 的 结果 如 图 4-11 所 示 。 


图 4-11 引发 事件 
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实例 72 框架 提供 的 委托 类 型 


【导语 】 

为 了 提高 开发 人 员 的 效率 (无 须 自 己 定义 过 多 的 委托 类 型 ),. NET 基础 框架 公开 了 许 
多 委托 类 型 ,并且 这 些 委托 类 型 都 带 有 泛 型 参数 ,可 以 最 大 程度 地 扩充 其 灵活 性 。 这 些 委托 
可 以 分 为 两 类 : 

(1) Action。 用 于 匹配 返回 类 型 为 void 的 方法 ,可 以 匹配 0 到 16 个 参数 的 方法 。 在 实 
际 开发 中 ,这 已 经 能 够 处 理 绝 大 部 分 的 情形 了 ,通常 很 少 会 定义 参数 过 多 的 方法 。 

(2) Func。 用 于 匹配 返回 类 型 为 非 void 类 型 的 方法 ,同样 也 能 匹配 0 到 16 个 输入 参 
数 。 所 有 Func 委托 的 泛 型 参数 列表 中 ,最 后 一 个 (TResult) 都 表示 方法 的 返回 值 类 型 。 例 
如 ,Func< int，int，string > 可 以 匹配 有 两 个 int 类 型 输入 参数 .返回 值 为 string 类 型 的 
南 法 ; 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Program 类 中 定义 两 个 返回 值 为 void 类 型 的 方法 。 


static void TestA( string name, int age) 
Console. WriteLine( $"{name} 今年 {age} 岁 了 。"); 
static void TestB(String name) 


Console. WriteLine(" 你 好 ,{0}"，name) ; 


步骤 3: 再 定义 两 个 返回 值 为 非 void 类 型 的 方法 。 


static int TestC(DateTime dt) 
return dt. Year; 


static long TestD( int start, int end) 


longr = 1L; 
int cur = start; 
while(cur <= end) 
{ 
rx*= cur; 
Curtt+; 
} 


return r; 


步骤 4: 使 用 Action 委托 绑 定 TestA 和 TestB 方法 。 


Action< string，int> dl = TestA; 
d1("Bob", 28); 

Action< string> d2 = TestB; 
da("Jim"); 


通过 泛 型 参数 指定 参数 的 个 数 和 数据 类 型 。 
步骤 5: 使 用 Func 委托 绑 定 TestC 和 TestD 方法 。 


Func <DateTime, int > d3 = TestC; 

Console. WriteLine(" 今 年 是 {0} 年 ."，d3(DateTime.Now) ); 
Func<int, int, long> d4 = TestD; 

long res = d4(2, 4); 

Console. WriteLine(" 计 算 结 果 :{0}"， res); 


指定 Func 委托 的 返回 类 型 总 是 在 泛 型 参数 的 最 后 一 个 
的 委托 ,返回 类 型 为 long, 因 此 使 用 的 委托 是 Func < int, int, long >。 


实例 73 将 方法 作为 参数 进行 传递 
【导语 】 
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。 例 如 上 面 要 绑 定 TestD 方法 


如 果 没 有 委托 类 型 ,是 无 法 将 一 个 方法 作为 参数 进行 传递 的 ,这 也 是 委托 的 另 一 个 作 
用 。 因 为 委托 本 身 是 类 ,属于 引用 类 型 ,通过 参数 传递 后 , 它 所 绑 定 的 方法 的 引用 也 随 之 被 
传递 。 虽然 是 间接 地 实现 将 方法 人 为 参数 传递 ,但 也 的 确 能 实现 该 功能 。 


本 实例 以 Predicate 委托 为 例 ,在 一 个 整形 数组 中 查找 出 可 以 被 2 或 3 整除 的 整数 。 


【操作 流程 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 一 个 数组 实例 ,类 型 为 int。 


int[] arr = { 16, 21, 20, 11, 18, 37, 41, 77 }; 


Predicate 委托 实例 可 以 用 于 数组 或 列表 类 型 ,主要 功能 是 用 于 查找 匹配 的 元 素 。 这 使 得 元 
素 的 查找 逻辑 与 集合 对 象 分 开 ,开发 者 可 以 通过 Predicate 委托 来 绑 定 自 定义 的 查找 方法 。 


步骤 3: 调用 FindAll 方 法 查找 所 有 匹配 的 元 素 ,被 找到 的 元 素 会 组 成 一 个 新 的 数组 并 


int[] resarr = Array.FindAll(arr, element => 


if(((element % 2) == 0) || ((element % 3) == 0)) 
{ 

return true; 
} 


return false; 
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Predicate 委托 的 声明 如 下 : 

public delegate bool Predicate< in T>(T obj); 
该 委托 带 有 一 个 本 泛 型 参数 ,可 以 最 大 限度 地 发 挥 其 灵活 
性 ,返回 类 型 为 布尔 类 型 ,如 果 元 素 找到 就 返回 true, 要 是 
找 不 到 就 返回 false。FindAll 方 法 在 访问 数组 中 的 每 个 元 
素 时 ,都 会 调用 Predicate 委托 实例 并 把 元 素 传递 进去 ,如 


国 CAprogram FL 一 口 x 


3 整除 的 整 效 有: 


16, 21, 20, 1 


果 返 回 true 表明 是 匹配 的 ,否则 就 是 不 匹配 的 。 图 4-12 输出 数组 中 可 被 
步骤 4: 运行 项 目 ,输出 结果 如 图 4-12 所 示 。 2 或 3 整除 的 整数 
实例 74 使 用 Lambda 表达 式 动态 产生 数据 
【导语 】 


Lambda 表达 的 作用 与 匿名 方法 相似 ,但 书写 起 来 比 匿名 方法 简洁 ,而 且 Lambda 方法 
能 够 让 编译 器 自动 推测 参数 的 数据 类 型 ,因此 一 般 只 需要 给 出 参数 名 称 即 可 ,不 要 求 明确 指 
定 参数 的 类 型 。Lambda 表达 式 可 以 直接 赋值 给 委托 变量 。 

Lambda 表达 式 的 格式 如 下 。 

( < 参数 列表 > ) = > < 方法 体 > 

如 果 没 有 参数 ,就 需要 一 对 空白 的 括号 。 

() => < 方法 体 > 

如 果 Lambda 表达 式 的 方法 体 有 多 行 代码 , 则 需要 写 在 一 对 大 括号 中 。 

本 实例 将 实现 一 个 类 ,类 的 构造 函数 接受 一 个 委托 对 象 ,该 委托 最 后 会 产生 一 个 字典 实 
例 ( 带 键 / 值 对 的 集合 ) ,并 且 该 类 会 公开 一 个 方法 ,调用 后 输出 字典 集合 中 的 数据 。 

【操作 流程 】 


步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 一 个 DataManage 类 。 


public class DataManage 
{ 


} 
步骤 3: 在 类 中 定义 一 个 私有 字段 ,用 于 存放 数据 。 


public class DataManage 
{ 
IDictionary < int, string> _dicData; 


} 
步骤 4: 定义 构造 函数 ,并 用 一 个 委托 作为 参数 ,委托 执行 后 会 返回 一 个 字典 集合 实例 。 
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public class DataManage 
{ 


IDictionary < int, string> dicData; 


public DataManage(Func < IDictionary < int, string>> data) 
{ 
_dicData = data(); 
} 
} 


步骤 5: 定义 一 个 公共 方法 ,将 字典 集合 中 的 数据 输出 到 屏幕 。 


public void DisplayData( ) 
{ 
Console. WriteLine(" ---- 数据 列表 ---- "); 
foreach(var kp in _dicData) 
{ 
Console. WriteLine ( $ "{kp.Key,4}\t{kp. Value}"); 
} 
} 


格式 化 字符 串 中 的 “,4” 表 示 输 出 的 文本 为 右 对 齐 ,长 度 为 4 个 字符 。 
步骤 6: 在 Main 方法 中 实例 化 DataManage 对 象 ,并 通过 构造 函数 传递 初始 数据 。 


DataManage dm = new DataManage(() => new Dictionary< int, string> 
{ 
[1] 
[2] 


"window", 
"house", 
[3] “ii, 
[4] "noodles", 
[5] = "claim" 
Wa 
步骤 7: 调用 DisplayData 方法 ,输出 字典 集合 中 的 数据 。 


dm.DisplayData( ); 


步骤 8: 运行 应 用 程序 项 目 ,输出 内 容 如 图 4-13 所 示 。 图 4-13 输出 字典 数据 
4.3 继承 与 多 态 


实例 75 调用 基 类 的 构造 函数 

【导语 】 

base 关键 字 可 以 访问 基 类 实例 的 成 员 , 例 如 构造 函数 .属性 ,方法 ,事件 等 ; 相对 的 ,this 
关键 字 代 表 的 是 当前 类 型 的 实例 。 只 能 在 当前 类 的 构造 函数 进入 代码 块 之 前 访问 基 类 的 构 
造 函 数 ,在 当前 类 的 其 他 地 方 不 能 访问 。 
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【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 A 类 ,定义 一 个 带 两 个 参数 的 构造 函数 ,随后 通过 两 个 公共 属性 公开 两 个 
参数 的 值 。 


class A 
{ 
public A(int v1, int v2) 
{ 
Valuel 
Value2 
} 


vl; 
2 


public int Valuel { get; } 
public int Value2 { get; } 
: 
步骤 3: 声明 B 类 ,从 A 类 派生 。 在 B 类 的 构造 函数 执行 之 前 ,调用 A 类 的 构造 函数 
并 传递 参数 。 


classB : 及 
{ 
public B() 
:base(900, 750) 
{ 


} 

} 

在 base 关键 字 之 前 ,需要 添加 一 个 英文 的 冒号 ,表示 先 执行 A 类 的 构造 函数 ,然后 青 
执行 B 类 的 构造 函数 。 

步骤 4: 实例 化 B 类 的 对 象 ,并 输出 Valuel 和 Value2 属性 的 值 。 

Bv = new B(); 

Console. WriteLine( $ "Value 1 

Console. WriteLine( $ "Value 2 

B 类 的 Valuel 和 Value2 属性 是 从 A 类 继承 的 。 

步骤 5: 按 下 F5 快捷 键 ,应 用 程序 将 输出 以 下 结果 。 


{v. Valuel}"); 
{v. Value2}"); 


Value 1 = 900 
Value 2 = 750 


实例 76 重 写 基 类 的 成 员 


【导语 】 
重 写 基 类 的 成 员 , 应 当 在 成 员 签名 上 加 override 关键 字 。 在 派生 类 中 重 写 基 类 的 成 员 ， 
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可 以 对 基 类 的 功能 进行 扩展 ,而 且 还 可 以 使 用 base 关键 字 来 访问 当前 成 员 的 基 类 版 本 。 

在 基 类 中 ,如果 和 希望 派生 类 能 够 重 写 某 个 成 员 ,应 该 在 成 员 签名 上 加 virtual 关键 字 ,将 
此 成 员 “ 虚 化 ”。 带 virtual 关键 字 的 成 员 既 可 以 包含 也 可 以 不 包含 实现 代码 。 

例如 以 下 两 种 形式 。 


// 基 类 

public virtual int GetItem ( string key ) 

// 派生 类 重 写 

public override int GetItem ( string key ) 

基 类 的 成 员 除 了 可 以 使 用 virtual 关键 字 外 ,还 可 以 用 abstract 关键 字 , 这 会 使 成 员 * 抽 
象 化 ”。 抽象 成 员 与 虚 成 员 不 同 , 虚 化 的 成 员 可 以 包含 也 可 以 不 包含 具体 的 实现 代码 ,而 抽 
象 成 员 是 不 能 包含 实现 代码 的 。 因 此 派生 类 必须 重 写 抽象 成 员 ,但 不 一 定 要 重 写 虚 成 员 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 MyBase 类 作为 基 类 ,并 定义 一 个 虚 方法 。 


class MYBase 
public virtual void Output() 
Console. WriteLine(" 基 类 的 方法 被 调用 。"); 
} 
步骤 3: 定义 MyTest 类 ,从 MyBase 类 派生 ,并 且 重 写 基 类 的 方法 。 


class MyTest : MyBase 


public override void Output() 
{ 
Console. WriteLine( "派生 类 的 方法 被 调用 。"); 
base. Output( ); 
} 
} 
通过 base 关键 字 , 可 以 调用 基 类 的 成 员 。 在 上 面 代码 中 , 先 执行 派生 类 的 代码 ,然后 再 
调用 基 类 的 方法 。 
步骤 4: 以 下 代码 可 以 测试 成 员 的 重 写 。 
MyTest t = new MyTest(); 
t. Output(); 


实例 77 彻底 替换 基 类 的 成 员 


【导语 】 
重 写 基 类 的 成 员 是 对 基 类 成 员 的 扩展 。 但 有 时 需要 彻底 蔡 换 基 类 的 成 员 , 即 虽然 成 员 
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的 名 称 与 基 类 的 成 员 相 同 , 但 功能 完全 不 同 。 

替换 基 类 成 员 ,应 当 在 成 员 签名 上 加 上 new 关键 字 , 格 式 如 下 。 

// 基 类 

public void Work () 

// 派生 类 蔡 换 

public new void Work() 

替换 成 员 一 般 应 用 于 : 派生 类 的 成 员 名 称 、 参 数 ,返回 值 类 型 与 基 类 的 相同 ,但 是 在 功 
能 上 是 完全 不 同 的 情形 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 CheckTask 类 ,公开 一 个 Run 方法 。 


class CheckTask 


public void Run( int max) 
{ 

Console. WriteLine(" 最 大 执行 任务 数 :{0}。"，nmax); 
} 


步骤 3: 定义 DRCheckTask 类 , 它 从 CheckTask 类 派生 。 
class DRCheckTask : CheckTask 


public new void Run( int count) 
{ 

Console. WriteLine(" 并 行 任务 数 :{0}。"，count); 
} 


在 DRCheckTask 类 中 也 有 一 个 Run 方法 ,并 且 参 数 与 基 类 的 Run 方法 相同 (都 是 int 
类 型 ) ,可 是 它们 所 代表 的 含义 (功能 ) 不 同 。 基 类 中 Run 方法 的 参数 表示 可 以 执行 的 最 大 
任务 数 ,而 DRCheckTask 类 的 Run 方法 中 参数 表示 要 并 行 的 任务 数 。 由 于 功能 完全 不 同 ， 
所 以 派生 类 中 应 该 用 new 关键 字 完 全 替换 基 类 的 Run 方法 。 

步骤 4: 分 别 实例 化 CheckTask 类 和 DRCheckTask 类 ,并 分 别 调用 它们 的 Run 方法 。 


CheckTask t1 = new CheckTask(); 
t1. Run(15); 


' CYProg. 一 口 x 


DRCheckTask t2 = new DRCheckTask(); 
t2. Run(10); 

去 行 应 用 项 i ey = 图 4-14 ”两 个 版 本 的 Run 
步骤 5: 运行 应 用 项 目 , 输 出 的 内 容 如 图 4-14 所 示 。 方法 的 输出 信息 
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实例 78 ”实现 多 个 接口 


【导语 】 

虽然 派生 类 不 能 同时 继承 多 个 类 ,但 可 以 同时 实现 多 个 接口 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 接口 ,各 包含 一 个 方法 。 


interface IRunnerl 


void StartWork( ); 


interface IRunner2 
{ 
void EndWork( ); 


步骤 3: 声明 一 个 测试 类 ,该 类 可 以 同时 实现 以 上 两 个 接口 。 


class OneWork : IRunnerl, IRunner2 


public void EndWork( ) 
‘ 

Console. WriteLine( "结束 操作 。"); 
} 


public void StartWork( ) 
{ 
Console. WriteLine(" 开 始 操 作 。"); 

} 
i 
IRunnerl 接口 包含 StartWork 方法 ,IRunner2 接口 包含 EndWork 方法 。OneWork 类 

同时 实现 这 两 个 接口 ,因此 该 类 包含 StartWork 和 EndWork 两 个 方法 。 

步骤 4: 下 面 代 码 对 OneWork 类 进行 测试 调用 。 
OneWork ow = new OneWork(); 


Ow. StartWork( ); 
Ow. EndWork( ) ; 


注意 : 类 所 实现 的 接口 成 员 都 应 该 是 公共 成 员 , 因 为 接口 的 用 途 就 是 作为 一 种 规范 ,用 以 确 
定 面向 对 象 编程 的 基本 模型 。 接 口 一 般 要 提供 给 外 部 进行 代码 调用 (实现 接口 的 类 
可 以 对 外 部 隐藏 ), 只 有 公共 成 员 才 能 被 外 部 代码 访问 。 
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实例 79 实现 接口 的 结构 

【导语 】 

结构 类 型 虽然 不 能 继承 ,但 结构 是 可 以 实现 接口 的 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 接口 类 型 ,其 中 包含 一 个 方法 。 


interface ITest 


int Rdd(int a, int b); 


步骤 3: 声明 一 个 实现 ITest 接口 的 结构 。 
struct TestCal : ITest 


public int Add(int a, int b) 
{ 
returna + b; 


} 


注意 : 结构 实现 接口 的 成 员 , 要 求 是 公共 成 员 。 


步骤 4: 在 Main 方法 中 编写 以 下 测试 代码 。 


ITest v = new TestCal(); 
int result = v.Add(10, 5); 
Console. WriteLine(" 计 算 结 果 :{0}"，result); 


步骤 5: 运行 应 用 程序 项 目 , 屏 幕 输出 的 结果 如 下 。 
计算 结果 :15 


实例 80 ”隐藏 构造 函数 


【导语 】 

把 构造 函数 声明 为 私有 成 员 , 无 法 从 类 的 外 部 访问 构造 函数 ,就 不 能 用 new 运算 符 来 
实例 化 对 象 了 ,于 是 就 达到 了 隐藏 构造 函数 的 目的 。 

隐藏 构造 函数 通常 用 于 特殊 用 途 的 类 型 ,例如 一 些 访问 某 个 硬件 设备 的 类 ,一 般 不 希望 
在 应 用 程序 生命 周期 内 创建 过 多 的 实例 ,因为 多 个 实例 同时 操作 一 个 设备 容易 产生 冲突 。 
所 以 隐藏 了 构造 函数 的 类 需要 对 外 公开 一 个 静态 成 员 ( 例 如 静态 属性 ) ,使 得 外 部 代码 能 够 
访问 到 类 型 实例 。 
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【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 Camara 类 ,模拟 相机 设备 。 
class Camara 


上 


private Guid _deviceID; 


private Camara() 


{ 
_deviceID = Guid. NewGuid(); 


} 


public Guid DeviceID => deviceID; 
} 
私有 字段 _deviceID 表示 设备 的 标识 ,并 由 DeviceID 属性 公开 。 构 造 函 数 加 了 private 
修饰 ,表明 该 构造 函数 无 法 被 外 部 访问 。 
步骤 3: 为 了 让 其 他 代码 能 够 访问 到 Camara 实例 ,需要 为 Camara 类 定义 一 个 静态 的 
公共 属性 ,以 获取 实例 引用 。 


private static Camara _currentInstance = new Camara(); 
public static Camara CurrentInstance => _currentInstance; 


步骤 4: 使 用 时 ,直接 通过 静态 属性 来 获取 Camara 类 的 实例 。 


Camara c = Camara.CurrentInstance; 
Console. WriteLine( $ "设备 标识 :{c. DeviceID}"); 


步骤 5: 运行 应 用 项 目 , 得 到 的 输出 内 容 如 下 。 


设备 标识 :lca3f63e- 8513 - 497a- aa5d- 7749a061e6c5 


实例 81 到 底 调 用 了 谁 


【导语 】 

抽象 类 一 般 可 以 作为 一 组 相关 类 型 的 公共 基 类 ,不 能 实例 化 , 它 仅 仅 为 后 续 继承 的 类 型 
提供 了 一 个 规范 。 抽 象 类 的 作用 与 接口 类 似 , 但 也 有 不 同 。 接 口 不 能 包含 任何 实现 代码 ,而 
且 接 口中 所 有 成 员 都 要 定义 为 公共 成 员 ; 抽象 类 中 既 可 以 包含 没有 实现 代码 的 抽象 成 员 ， 
也 可 以 包含 实现 的 类 型 成 员 。 继 承 抽象 类 的 派生 类 必须 实现 其 抽象 成 员 。 


注意 : 抽象 类 中 可 以 包含 非 抽象 成 员 , 但 非 抽象 类 中 是 不 能 包含 抽象 成 员 的 。 因 为 非 抽 象 
类 可 以 实例 化 ,并 且 抽 象 成 员 没 有 任何 实现 代码 , 即 通过 非 抽 象 类 实例 访问 抽象 成 员 
没有 实际 意义 。 
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当 从 抽象 类 派生 时 ,实现 抽象 成 员 的 方法 与 重 写 虚 成 员 相 近 , 都 使 用 override 关键 字 。 
抽象 成 员 不 包含 任何 实现 代码 ,完全 交 由 派生 类 实现 。 当 通过 抽象 类 型 的 变量 去 调用 抽象 
成 员 时 ,应 用 程序 会 根据 赋值 给 变量 的 类 型 实例 来 决定 执行 哪些 代码 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 名 为 Animal 的 抽象 类 ,表示 某 种 动物 ,并 且 包 括 一 个 抽象 的 Name 属性 。 


abstract class Rnimal 


{ 
public abstract string Name { get; } 


} 


从 Animal 派生 的 类 必须 实现 Name 属性 。 
步骤 3: 声明 三 个 类 ,都 实现 抽象 类 Animal( 即 从 Animal 类 派生 ) 。 


class Cat : Rnimal 


public override string Name => " 猫 猫 "; 


class Rabbit : Animal 


public override string Name => "兔子 "; 


class Dog : Animal 


public override string Name =>" 狗 狗 "; 


每 个 派生 类 都 可 以 根据 具体 的 情况 ,为 Name 属性 返回 不 同 的 值 。 

步骤 4: 在 Main 方法 中 ,声明 三 个 Animal 类 型 的 变量 ,并 分 别 为 每 个 变量 赋值 Cat、 
Rabbit 和 Dog 的 类 型 实例 。 

Animal al = new Cat(); 


Animal a2 new Rabbit(); 
Animal a3 new Dog( ); 


步骤 5: 分 别 访问 它们 的 属性 。 


Console. WriteLine( $ "这 只 宠物 是 {al. Name}"); 
Console. WriteLine( $ "这 只 宠物 是 {a2. Name}"); 
Console. WriteLine( $ "这 只 宠物 是 {a3. Name}"); 


步骤 6: 运行 应 用 程序 项 目 ,输出 结果 如 下 。 
这 只 宠物 是 猫 猫 


这 只 宠物 是 兔子 
这 只 宠物 是 狗 狗 
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当 访 问 al 的 Name 属性 时 实际 上 是 访问 Cat 实例 的 Name 属性 , 同 理 , 在 访问 a2 变量 
时 实际 上 是 访问 Rabbit 实例 的 Name 属性 ,因此 调用 谁 的 Name 属性 取决 于 为 变量 所 赋 的 


具体 实例 。 
实例 82” 析 构 函 数 
【导语 】 


析 构 函数 与 构造 函数 的 作用 正好 相反 。 构 造 函 数 在 创建 对 象 实例 时 调用 ,用 于 对 类 型 


成 员 初始 化 ; 而 析 构 函数 则 是 在 对 象 实例 即将 被 回收 时 执行 ,可 用 二 


F 一 些 清理 工作 。 


析 构 函数 都 以 “一 ”开头 ,无 返回 值 无 参数 ,“~~" 之 后 紧 跟 类 名 (无 空格 ) ,格式 如 下 。 


class Desk 


{ 
~Desk() 


{ 


} 
} 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 声明 一 个 用 于 测试 的 Example 类 ,并 且 定 义 它 的 构造 函数 与 析 构 函数 。 


class Example 
{ 
public Example() 
{ 
WriteLine(" 构 造 函 数 被 调用 。"); 
} 


一 Example() 
{ 
WriteLine(" 析 构 函 数 被 调用 。"); 
} 
$F 


步骤 3: 在 Program 类 中 声明 一 个 静态 方法 ,在 方法 中 声明 一 个 Example 类 的 变量 并 


进行 实例 化 。 


static void Test() 
{ 

Example ex = new Example(); 
} 
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由 于 变量 ex 是 在 方法 内 部 声明 的 ,其 生命 周期 在 执行 完 方法 后 就 会 结束 。 因 此 在 方法 
外 部 可 以 显 式 调用 GC 的 相关 方法 进行 垃圾 回收 ,只 有 当 对 象 实例 被 回收 时 , 析 构 函数 才 会 
被 调用 。 
步骤 4: 在 Main 方法 中 调用 Test 方法 ,随后 立即 调用 GC 的 Collect 方法 进行 内 存 回 收 。 


Test(); 
// 进行 垃圾 回收 
GC. Collect(); 


实例 83 ”实现 IDisposable 接口 


【导语 】 
通过 实现 IDisposable 接口 进行 回收 清理 , 比 析 构 函数 更 易于 使 用 。 首 先 , 实现 
IDisposable 接口 后 ,类 型 会 公开 Dispose 方法 ,可 以 在 代码 中 随时 调用 以 执行 清理 工作 ; 其 
次 ,实现 了 IDisposable 接口 的 类 型 可 用 于 using 语句 块 , 当 using 语句 块 代码 执行 完成 后 会 
自动 调用 Dispose 方法 来 清理 资源 。 
本 实例 实现 了 一 个 可 以 向 文本 文件 写 入 内 容 的 类 。 类 中 包含 一 个 文件 流 实例 , 它 会 占 
用 文件 以 及 相关 的 内 存 资 源 , 在 类 的 构造 函数 中 初始 化 ,并 在 Dispose 方法 中 释放 文件 流 所 
占用 的 资源 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 TextWriter 类 ,里 面包 装 了 一 个 文件 流 对 象 ,可 以 将 字符 串 写 入 文件 , 详 
见 代码 清单 4-5。 
代码 清单 4-5 ”TextWriter 类 完整 代码 
class TextWriter : IDisposable 
{ 
// 文件 名 
const string FILE_NAME = "demo. txt"; 
// 文件 流 


FileStream fsWriter = null; 


public TextWriter() 
{ 

// 打开 或 创建 文件 

fsWriter = File.OpenWrite(FILE NAME); 
} 


public void WriteText(string str) 
{ 
// 获取 文本 的 字 节 数组 


第 4 章 ”面向 对 象 编程 | 也 111 


byte[ ] data = Encoding. UTF8.GetBytes(str); 
// 将 字 节 数组 写 人 文件 流 
fsWriter. Write(data, 0, data. Length) ; 
// 将 缓冲 的 数据 写 人 文件 
fsWriter. Flush( ); 
} 


public void Dispose() 

{ 
// 关闭 文件 流 
fsWriter?. Close(); 
// 释放 资源 


fsWriter? .Dispose(); 


} 


步骤 3: 使 用 TextWriter 时 ,可 以 将 其 实例 放 在 using 语句 块 中 ,当代 码 流程 执行 完 退 
出 using 语句 块 后 ,TextWriter 中 实现 的 Dispose 方法 就 会 被 调用 ,以 进行 资源 清理 工作 。 

using(TextWriter wt = new TextWriter()) 

{ 

wt. WriteText(" 编 程 真 快乐 。"); 

} 

调用 WriteText 方法 可 以 向 文件 写 入 文本 内 容 。 

步骤 4: 按 下 F5 快捷 键 运行 应 用 程序 , 待 程序 退出 后 ,再 找到 项 目 路 径 下 的 \bin\ 
Debug\netcoreapp < 版 本 号 > 子 目录 ,会 看 到 一 个 名 为 demo. txt 的 文件 ,应 用 程序 所 写 入 的 
文本 内 容 就 存放 在 该 文件 中 。 

实例 84” 显 式 实现 接口 

【导语 】 

显 式 实现 接口 就 是 在 实现 接口 的 成 员 前 面 加 上 接口 的 名 称 。 这 种 方法 可 以 有 效 解决 接 
口 成 员 冲 突 问题 。 例 如 ,IA 接口 中 包含 Play 方法 ,而 IB 接口 中 也 包含 Play 方法 , 若 使 用 常 
规 方式 同时 实现 这 两 个 接口 ,那么 类 型 中 只 能 有 一 个 Play 方法 。 例 如 下 述 代 码 。 


interface IR { 
void Play(); 
} 
interface IB { 
void Play(); 
} 
class Test : IA, IB 
{ 
public void Play() { } 
} 
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因为 两 个 接口 中 Play 方法 的 签名 相同 ,只 能 出 现 一 个 。 假 设 这 两 个 接口 中 的 Play 方 
法 签名 相同 ,但 是 所 代表 的 功能 和 含义 不 同 , 即 IA 接口 中 的 Play 方法 用 来 播放 音乐 ,而 IB 
接口 中 的 Play 方法 用 来 开始 玩 游戏 。 要 同时 实现 这 两 个 Play 方法 ,就 要 让 它 显 式 地 实现 
两 个 接口 了 。 上 述 代码 可 以 修改 为 以 下 形式 。 
class Test : IA, IB 
{ 
void IA.Play() { } 
void IB. Play() { } 
} 
显 式 实现 接口 后 ,无 法 通过 实现 类 的 变量 去 调用 Play 方法 ,必须 使 用 接口 来 声明 变量 
才能 访问 。 例 如 ,如 果 要 调用 IA 接口 的 Play 方法 ,就 要 用 IA 类 型 去 声明 变量 ,赋值 时 引用 
Test 类 的 实例 ,然后 再 通过 变量 调用 Play 方法 。 


IAv = new Test(); 
v.Play(); 


使 用 以 下 代码 是 无 法 访问 Play 方法 的 。 


Test x = new Test(); 
x. Play(); 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 两 个 接口 ,它们 都 包含 一 个 Start 方法 。 


interface IDownloader 
{ 
void Start( ); 
} 
interface IUploader 


{ 
void Start(); 
IDownloader 接口 模拟 一 个 从 网 络 下 载 数据 的 操作 ,IUploader 接口 则 模拟 一 个 向 网 络 
上 传 数据 的 操作 。 很 明显 ,两 个 Start 方法 尽管 签名 相同 但 功能 不 同 , 一 个 开启 下 载 操作 , 另 一 
个 开启 上 传 操作 ,因此 如 果 某 个 类 型 同时 实现 这 两 个 接口 ,就 必须 显 式 实现 两 个 Start 方法 。 
步骤 3: 声明 一 个 类 ,同时 实现 以 上 两 个 接口 此 处 必须 使 用 显 式 实现 接口 的 方式 ,否则 
无 法 同时 完成 两 个 Start 方法 的 实现 。 
class NetworkManager : IDownloader, IUploader 
{ 
void IDownloader. Start() 


{ 
Console. WriteLine(" 正 在 下 载 ,请 稍 等 … … a 
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} 


void IUploader. Start() 
和 
Console. WriteLine(" 内 容 上 传 中 ,请 稍 等 … …"); 
} 
} 


步骤 4: 在 使 用 时 ,可 以 先 实例 化 NetworkManager 类 。 
NetworkManager mng = new NetworkManager(); 

步骤 5: 要 启动 下 载 或 上 传 操作 ,必须 通过 相应 的 接口 变量 来 调用 。 
// 要 下 载 ,只 能 通过 IDownloader 接口 类 型 的 变量 来 访问 


IDownloader dl = mng; 

dl. Start(); 

// 要 上 传 ,也 只 能 通过 IUploader 接口 类 型 的 变量 来 访问 
IUploader ul = mng; 

ul.Start(); 


因为 NetworkManager 类 同时 实现 了 这 两 个 接口 ,所 以 
NetworkManager 类 的 实例 可 以 赋值 给 使 用 接口 类 型 声明 的 变 


量 , 属 于 隐 式 转换 。 图 4-15 调用 显 式 实现 
步骤 6: 运行 应 用 程序 项 目 ,会 看 到 如 图 4-15 所 示 的 输出 结果 。 接口 的 成 员 
实例 85 阻止 类 被 继承 
【导语 】 


出 于 对 象 模型 的 实际 需要 ,有 时 需要 禁止 某 个 类 被 继承 ,即使 其 成 为 密封 类 。 以 下 实例 
简单 演示 了 使 用 sealed 关键 字 声 明 密封 类 的 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 Pear 类 .并 加 上 sealed 关键 字 ( 在 class 关键 字 之 前 ) 。 


sealed class Pear 


步骤 3: 尝试 从 Pear 类 派生 出 WildPear 类 。 


class WildPear : Pear 


此 时 会 提示 错误 ,因为 Pear 类 已 经 是 密封 类 ,无 法 被 继承 。 
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实例 86” 谋 套 类 

【导语 】 

所 谓 嵌 套 类 ,就 是 在 类 中 又 声明 一 个 类 。 岩 套 类 之 间 虽 然 产生 了 层级 关系 ,但 每 个 类 都 
是 独立 的 ,也 就 是 说 ,一 个 类 的 内 部 是 不 能 访问 其 内 套 类 的 。 如 果 要 访问 ,只 能 通过 变量 来 
传递 。 例 如 ,A 类 中 嵌 套 了 B 类 ,在 A 类 内 部 想 访 问 B 类 实例 时 ,可 以 先 在 A 类 中 声明 一 
个 BB 类 的 私有 字段 并 引用 有 效 的 B 类 实例 ,再 通过 这 个 私有 字段 访问 B 类 的 某 个 实例 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 公共 类 ,类 中 包含 一 个 公共 方法 以 及 一 个 嵌 套 类 。 

public class TheOut 

{ 


// 公开 一 个 属性 用 于 设置 TheNest 实例 ,以 便 在 类 中 访问 TheNest 实例 
public TheNest NestObj { get; set; } 


public void CallNest() 
{ 

NestObj?. CallMe( ); 
} 


public class TheNest 
{ 
public void CallMe() => WriteLine(" 正 在 访问 嵌 套 的 类 实例 .")， 
} 
} 
尽管 TheNest 类 包含 在 TheOut 类 中 ,然而 它们 被 视 为 独立 的 类 , 即 类 名 分 别 为 
TheOut 与 TheOut. TheNest。 为 了 让 TheOut 类 中 的 代码 能 访问 TheNest 实例 ,本 实例 的 
处 理 方法 是 在 TheOut 类 中 公开 一 个 NestObj 属性 ,该 属性 可 以 设置 对 TheNest 类 实例 的 
引用 ,这 样 在 TheOut 类 的 CallNest 方法 中 就 可 以 使 用 TheNest 实例 了 。 
步骤 3: 对 嵌 套 类 的 使 用 进行 测试 。 分 别 创建 两 个 类 的 实例 ,然后 把 TheNest 类 的 实 
例 赋 值 给 NestObj 属性 。 
TheOut objl = new TheOut(); 


TheOut. TheNest obj2 = new TheOut. TheNest(); 
obj1. NestObj = obj2; 


步骤 4: 然后 就 能 访问 嵌 套 类 中 的 CallMe 方法 了 。 


obj1.CallNest(); 


注意 : 访问 嵌 套 类 的 类 名 时 ,需要 加 上 它 的 父 级 类 的 类 名 。 例 如 本 实例 中 ,在 声明 obj2 变 
量 时 ,类 名 要 写成 TheOut. TheNest, 中 间 使 用 成 员 运 算 符 (半角 多 号 ) 连 接 。 
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实例 87 ”匿名 类 型 


【导语 】 

匿名 类 型 是 一 种 比较 方便 实用 的 轻型 对 象 模 型 。 使 用 之 前 无 须 在 代码 中 声明 新 的 类 ， 
类 型 名 称 由 编译 器 自动 分 配 。 因 此 开发 者 事先 不 会 知道 匿名 类 型 的 名 称 ,无 法 在 代码 中 直 
接 访 问 类 型 信息 。 
正 是 由 于 匿名 类 型 的 类 型 名 称 无 法 预先 知晓 ,所 以 在 声明 匿名 类 型 的 变量 时 只 能 使 用 
var 关键 字 , 让 编译 自动 推测 变量 的 类 型 。 初 始 化 匿名 类 型 实例 时 依然 使 用 new 运算 符 。 
后 面 紧 跟 对 象 初始 化 代码 ( 写 在 一 对 大 括号 中 )。 例 如 ,下 面 代 码 声 明 一 个 匿名 类 型 的 变量 
工 , 并 使 用 new 运算 符 初 始 化 。 


var x = new 


{ 

City = "天 津 "， 

Phone = "13477689366" 

}; 

只 能 分 配 公共 的 只 读 属性 给 匿名 对 象 ,因此 必须 在 初始 化 时 赋值 属性 。 匿 名 对 象 初始 
化 后 ,属性 都 是 只 读 的 ,无 法 在 代码 中 修改 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Main 方法 中 声明 一 个 变量 ,并且 使 用 匿名 对 象 进行 赋值 。 


vard = new 

{ 
Color = "白色 "， 
Size = 43.6f, 
Number = 7988 

}; 

给 属性 赋值 的 时 候 ,直接 写 上 属性 的 名 称 赋值 即 可 ,编译 器 会 自动 推测 属性 的 类 型 。 

步骤 3: 输出 匿名 对 象 的 各 个 属性 的 值 。 

string str = $" 颜 色 :{d. Color}\n 尺码 : {d. Size} \n 编号 : 


{d. Number}"; 
Console. WriteLine(" 商 品 信息 :\n{0}"， str); 


步骤 4: 按 下 F5 快捷 键 ,运行 项 目 , 屏 幕 输出 结果 如 图 4-16 
所 示 。 图 4-16 输出 匿名 对 
和 象 的 属性 值 
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4.4 枚 举 


实例 88 ”声明 枚 举 类 型 


【导语 】 

枚 举 类 型 由 一 组 常量 值 组 成 ,而 且 这 些 常 量 是 可 以 命名 的 。 在 向 变量 赋值 时 ,必须 从 枚 
举 类 型 所 定义 的 值 中 选择 一 项 。 例 如 ,一 个 枚 举 可 以 表示 电源 开关 的 状态 ,假设 On 表示 开 
关 处 于 “打开 ”状态 ,并 分 配 整 数值 1; Off 表示 “关闭 ”状态 ,分 配 整 数值 0。 当 要 对 电源 开关 
的 状态 进行 更 新 时 ,只 能 选择 On 或 者 Off, 不 会 出 现 其 他 的 值 。 因 此 , 枚 举 类 型 也 能 起 到 一 
种 规范 选项 的 作用 。 枚 举 中 各 个 常量 值 都 是 整数 值 (如 byte、int、long、uint 等 ), 所 以 枚 举 
属于 值 类 型 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 枚 举 类 型 ,并 分 配 三 个 值 。 


enum Options 


{ 


OneWay = 1, 
TwoWay = 2, 
MixWay = 3 


} 


声明 枚 举 类 型 需要 使 用 enum 关键 字 。 其 中 ,OneWay、TwoWay、MixWay 是 常量 的 名 
称 ,1、2、3 是 常量 的 值 。 为 常量 分 配 一 个 有 意义 的 名 字 ,可 以 方便 识别 和 记忆 。 

步骤 3: 在 Main 方法 中 用 上 面 定义 的 枚 举 类 型 声明 三 个 变量 ,并 分 别 赋 不 同 的 常量 值 。 

Options a = Options. OneWay; 

Options b 

Options c 

在 给 枚 举 变量 赋值 时 ,直接 访问 枚 举 类 型 的 常量 名 即 可 。 

步骤 4: 将 三 个 变量 所 使 用 的 枚 举 常量 名 与 常量 值 分 别 输出 到 屏幕 。 

WriteLine( $ "常量 名 :{a}, 常 量 值 :{ (int)a}"); 

WriteLine( $ "常量 名 :{b}, 常 量 值 :{ (int)b}"); 

WriteLine( $ "常量 名 :{c}, 常 量 值 :{ (int)c}"); 
因为 枚 举 的 常量 值 是 整数 值 ,并且 默认 使 用 int 类 型 的 
值 ,因此 要 获取 某 个 常量 的 值 ,可 以 直接 将 它 转 换 为 int 类 
型 的 值 。 图 4-17 输出 枚 举 的 常量 


2 S 名 称 与 常量 值 
步骤 5: 运行 应 用 程序 项 目 , 输 出 内 容 如 图 4-17 所 示 。 


Options. TwoWay; 


Options. MixWay; 


CNProgram Fi 一 口 x 
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实例 89 指定 枚 举 的 基础 类 型 

【导语 】 

在 声明 枚 举 类 型 时 ,如 果 不 指定 其 基础 类 型 , 则 其 常量 值 默 认为 int 类 型 。 在 有 特殊 需 
要 的 情况 下 ,可 以 明确 指定 枚 举 中 常量 值 的 基础 类 型 。 必 须 使 用 整数 值 的 基础 类 型 ,例如 
int\byte uint long .ulong 等 ,不 能 使 用 非 整数 类 型 ,例如 double。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 枚 举 类 型 ,指定 其 常量 值 基于 byte 类 型 。 


public enum ReadMode : byte 


NewFile = 1, 
OpenCurrent = 2, 
Saved = 3 


步骤 3: 再 声明 一 个 枚 举 类 型 ,常量 类 型 为 uint。 


public enum PictureQt : uint 


HO 
IO 
MQ 


4, 
U2y 
wy 


注意 : 指定 枚 举 常量 的 基础 类 型 使 用 半角 冒号 来 表示 ,与 类 之 间 的 继承 相似 。 


实例 90 常量 的 标志 位 运算 
【导语 】 
因为 枚 举 类 型 的 基础 类 型 是 整数 类 型 ,因此 , 枚 举 的 常量 值 之 间 也 可 以 进行 位 运算 。 即 
按 位 “与 ”And) , 按 位 “或 "(Or) ,以 及 取 反 (Not) 、 异 或 (Xor) 等 。 
支持 按 位 运算 的 枚 举 类 型 在 声明 时 需要 应 用 FlagsAttribute, 例 如 以 下 形式 。 


[FlagsAttribute] 
enum MultiHue : short 
{ 


None = 0, 
Black = 1, 
Red = 2, 


Green = 4, 
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Blue = 8 
}; 


如 果 和 希望 枚 举 类 型 的 值 支持 位 运算 ,不 仅 要 在 类 型 定义 时 使 用 FlagsAttribute, 还 必须 


注意 每 个 常量 值 的 合理 安排 。 一 般 来 说 ,常量 值 是 以 2 为 底数 的 寡 运 算 结 果 。 例 如 1、2、4、 


8、16、32 等 。 每 个 常量 值 只 有 作为 标志 的 二 进 制 位 才 为 1, 其 他 位 均 为 0。 


例如 上 面 举例 的 MultiHue 枚 举 ,None 的 常量 值 为 0, 转换 为 二 进 制 为 0000; Black 的 


常量 值 转换 为 二 进 制 为 0001; Red 的 常量 值 转换 为 二 进 制 为 0010; Green 的 常量 值 转换 为 
二 进 制 为 0100; Blue 的 常量 值 转换 为 二 进 制 为 1000 。 


如 果 将 Black 和 Red 两 个 值 组 合 ,得 到 的 结果 为 0011, 如 果 将 Green 和 Blue 两 个 值 进 


行 组 合 , 得 到 的 结果 为 1100。 如 果 将 MultiHue 枚 举 的 所 有 值 都 进行 组 合 ,得 到 的 结果 
为 1111。 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 枚 举 类 型 ,并且 应 用 FlagsAttribute, 使 其 支持 按 位 运算 。 
[Flags] 


enum TrackItem 


{ 


Trackl = 1, 
Track2 = 2, 
Track3 = 4, 
Track4 = 8, 
Track5 = 16 


注意 : 虽然 在 不 应 用 FlagsAttribute 的 情况 下 , 枚 举 的 常量 值 仍然 能 够 进行 按 位 运算 ,但 是 


当 调 用 枚 举 实例 的 ToString 方法 时 ,是 无 法 正确 返回 常量 值 的 名 称 的 。 如 果 应 用 了 
FlagsAttribute, 调 用 ToString 方法 可 以 得 到 已 经 组 合 的 常量 名 称 列 表 , 并 且 以 半角 
过 号 隔 开 。 


步骤 3: 在 项 目 模板 生成 的 Program 类 中 声明 一 个 静态 方法 ,用 于 在 屏幕 上 输出 经 过 


组 合 运算 后 的 枚 举 实例 的 常量 名 称 以 及 常量 的 二 进 制 值 。 


static void OutputInfo(TrackItenm 七 ) 

{ 
string pl = t.ToString(); 
string p2 = Convert.ToString((int)t, 2).PadLeft(5, '0'); 
Console. WriteLine( $ "{p2, 一 4} -- {p1}"); 

E 


步骤 4: 在 Main 方法 中 ,声明 几 个 枚 举 变量 ,并 赋予 经 过 组 合 后 的 枚 举 值 ,然后 调用 
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OutputInfo 方法 进行 测试 。 


// 将 Trackl 与 Track2 组 合 

TrackIten tl = TrackItem.Trackl | TrackItem. Track2; 

QutputInfo(t1); 

// 将 Track3、Track4、Track5 进行 组 合 

TrackItem t2 = TrackItem. Track3 | TrackItem. Track4 | TrackItem. Track5; 

OutputInfo(t2); 

// 将 枚 举 中 所 有 值 都 进行 组 合 

TrackItem t3 = TrackItem. Trackl | TrackItem. Track2 | TrackItem. Track3 | TrackItem. Track4 | 
TrackItem. Track5; 

QutputInfo(t3); 


步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 4-18 所 示 。 


图 4-18 输出 按 位 运算 后 的 枚 举 值 


步骤 6: 在 声明 枚 举 类 型 的 时 候 ,是 允许 使 用 表达 式 的 计算 结果 来 给 常量 赋值 的 。 可 以 
在 上 面 声明 的 TrackItem 枚 举 中 添加 一 个 AllTracks 常量 ,然后 它 的 值 就 是 前 面 5 个 常量 
值 的 组 合 。 

[Flags] 


enum TrackItem 


{ 


Trackl = 1, 
Track2 = 2, 
Track3 = 4, 
Track4 = 8, 
Track5 = 16, 


AllTracks = Trackl | Track2 | Track3 | Track4 | Track5 


实例 91 自动 产生 的 常量 值 


【导语 】 
如 果 在 一 个 枚 举 类 型 中 ,没有 为 任何 常量 明确 赋值 ,就 像 这 样 : 


enum Type 
{ 

Run, Stop, Close 
} 
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这 种 情况 下 常量 会 自动 产生 从 0 开始 ,并 按 顺 序 排 列 的 整数 值 。 例 如 ,上 面 的 Type 枚 举 ， 
Run 常量 的 值 为 0,Stop 常量 的 值 为 1,Close 常量 的 值 为 2。 
如 果 遇 到 明确 赋值 的 常量 ,而 其 后 的 常量 未 明确 赋值 的 情况 ,例如 : 


enum Test 


{ 


} 


其 中 ,Toy 常量 没有 明确 赋值 ,所 以 默认 为 0。Pie 明确 赋值 为 5, 而 且 Pie 之 后 的 常量 都 没 
有 明确 赋值 ,因此 以 Pie 常量 的 5 为 基础 自动 生成 整数 值 , 即 Ship 常量 的 值 为 6,Fox 常量 
的 值 为 7。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 枚 举 类 型 。 


enum Example 

{ 
ItemA = 3, 
ItemB, 
ItemC = 10, 
ItemD, 
ItemE 

E 


ItemA 明确 赋值 为 3, 因 此 ItemB 自动 分 配 值 4,ItemcC 赋值 为 10, 于 是 ItemD 自动 分 
配 值 11 ,ItemE 自动 分 配 值 12 。 
步骤 3: 声明 Example 枚 举 的 变量 并 进行 赋值 ,然后 输出 常量 对 应 的 整数 值 。 


Example Y = Example. ItemA; 
WriteLine( $ "{y} = {(int)y}"); 
Y = Example. ItemB; 

WriteLine( $ "{y} = {(int)y}"); 
y = Example. ItemD; 

WriteLine( $ "{y} = {(int)y}"); 


步骤 4: 按 F5 快捷 键 运行 应 用 程序 项 目 ,结果 如 图 4-19 图 4-19 输出 枚 举 中 自动 
所 示 。 产生 的 常量 值 
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实例 92 获取 枚 举 中 常量 的 名 称 


【导语 】 

在 .NET 类 库 中 有 一 个 Enum 类 , 它 是 枚 举 类 型 的 隐 式 基 类 。 在 代码 中 声明 枚 举 类 型 
时 无 须要 继承 Enum 类 。Enum 类 提供 一 系列 方法 (包括 实例 方法 和 静态 方法 ) ,可 以 对 枚 
举 类 型 进行 各 种 处 理 。 例 如 ,本 实例 需要 获取 枚 举 类 型 中 常量 的 名 称 ,对 应 地 ,在 Enum 类 
中 有 两 个 静态 方法 可 以 完成 此 功能 。 

其 中 ,GetName 方法 只 能 获取 枚 举 类 型 中 单个 常量 的 名 称 , 因 此 调用 该 方法 时 需要 提 
供 一 个 具体 的 常量 ; 而 GetNames 方法 可 以 获取 枚 举 类 型 中 所 有 已 定义 常量 的 名 称 , 以 字 
符 串 数组 的 形式 返回 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 System 命名 空间 下 有 一 个 DayOfWeek 枚 举 , 它 定义 了 一 周 七 天 的 名 称 ( 从 
星期 天 到 星期 六 )。 可 以 使 用 Enum 类 的 GetNames 方法 获取 DayOfWeek 枚 举 中 所 有 常量 
的 名 称 。 


string[ ] days = Enum. GetNames(typeof(DayOfWeek) ); 


步骤 3: 使 用 foreach 循环 把 字符 串 数组 中 的 元 素 输出 到 屏 


foreach(string d in days) 
{ 


Console. WriteLine(d); 4-20 DayOf Week 
} 枚 举 中 的 常 
步骤 4: 运行 应 用 程序 项 目 ,屏幕 输出 结果 如 图 4-20 所 示 。 量 名 称 列表 
实例 93 检查 枚 举 实例 中 是 否 包含 某 个 标志 位 
【导语 】 


枚 举 类 型 的 常量 值 可 以 组 合 起 来 使 用 ,在 实际 开发 中 ,经 常 需要 检查 枚 举 实例 中 是 否 包 
含 指定 的 标志 位 。 例 如 , 枚 举 类 型 Demo 中 定义 了 三 个 常量 ,分 别 命名 为 A、B、C, 假 设 声明 
了 一 个 变量 k, 并 在 赋值 时 将 A 和 了 组合。 


Demo k = Demo.A | Demo.B; 


在 代码 中 有 两 种 方法 可 以 检查 变量 k 的 值 中 有 没有 包含 A。 一 种 方法 就 是 把 变量 k 与 
Demo. A 的 值 进行 按 位 “与 ”运算 。 由 于 “与 ”运算 时 只 有 两 个 标志 位 同时 为 1 时 才能 得 到 结 
果 1, 因 此 ,把 变量 k 与 Demo. A 进行 按 位 “与 运算 后 ,如 果 变 量 k 中 包含 A 的 标志 位 , 那 
么 运算 的 结果 就 是 Demo. A, 因 为 其 他 标志 位 在 运算 后 都 为 0; 如 果 变 量 中 没有 A 的 标 
志 位 ,那么 跟 Demo. A 进行 按 位 “与 ”运算 后 的 结果 就 是 0。 还 有 一 种 方法 ,可 以 调用 枚 举 类 
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型 实例 的 HasFlag 方法 ,通过 参数 传递 要 被 检查 的 常量 值 , 如 果 变量 中 包含 指定 的 标志 位 ， 
HasFlag 方法 返回 true, 和 否则 返回 false。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 枚 举 类 型 Test, 并 在 其 上 面 应 用 FlagsAttribute, 表 示 它 支持 组 合 
使 用 。 

[Flags] 


enum Test 


{ 
Model, Mode2, Mode3 
: 


步骤 3: 声明 一 个 枚 举 类 型 的 变量 ,并 将 Mode2 和 Mode3 两 个 常量 组 合 赋值 。 
Test t = Test.Mode2 | Test.Mode3; 

步骤 4: 使 用 HasFlag 方法 检查 变量 中 是 否 包 含 Mode3 标志 位 。 

bool b = t.HasFlag(Test. Mode3); 


步骤 $: 再 声明 一 个 变量 ,将 Model 、Mode2、Mode3 三 个 常量 进行 组 合 。 


Test t2 = Test.Model | Test.Mode2 | Test.Mode3; 
步骤 6: 通过 按 位 “与 "运算 来 检查 变量 中 是 否 包 含 Model 标志 位 。 


bool b2 = (t2 & Test.Model) == Test.Model; 


4.5 特性 


实例 94 自 定义 特性 类 


【导语 】 

特性 是 一 种 比较 特殊 的 类 ,通常 作为 代码 对 象 的 附加 部 分 ,用 于 向 运行 时 提供 一 些 补充 
信息 。 特 性 一 般 有 以 下 特征 。 

(1) 从 Attribute 类 派生 。 

(2) 类 型 名 称 一 般 以 Attribute 结尾 。 尽 管 这 不 是 语法 规则 ,但 开发 者 应 当 遵守 这 一 约 
定 。 使 用 以 Attribute 结尾 的 类 名 ,一 方面 便于 他 人 识别 (一 看 名 字 就 知道 是 特性 类 ); 另 一 方 
面 , 在 输入 代码 时 可 以 将 Attribute 后 缀 省略 ,编译 器 能 够 自动 识别 。 例如， 
MTAThreadAttribute 类 是 一 个 特性 类 ,在 代码 中 可 以 直接 输入 MTAThread 。 

(3) 在 声明 特性 类 时 必须 在 类 上 应 用 AttributeUsageAttribute。AttributeUsageAttribute 
本 身 也 是 一 个 特性 类 ,用 于 标注 当前 声明 的 特性 类 应 用 于 哪些 对 象 。 例 如 ,该 特性 是 否 只 能 在 
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类 上 面 应 用 ,还 是 可 以 同时 在 类 、 属 性 和 方法 上 应 用 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 自 定义 的 特性 类 ,命名 为 MyDemoAttribute。 


[AttributeUsage(AttributeTargets. Property | AttributeTargets. Method) ] 

public class MyDemoAttribute : Attribute 

{ 

public string Description { get; set; } 

’ 

通过 应 用 AttributeUsageAttribute, 指 明 MyDemoAttribute 只 能 应 用 在 属性 和 方法 
上 面 。 

步骤 3: 声明 一 个 类 ,并 在 类 的 属性 和 方法 上 应 用 上 面 自 定义 的 特性 。 

public class OrderData 


{ 
[MyDemo(Description = "订单 ID")] 
public int OrdID { get; set; } 


[MyDemo(Description = "添加 时 间 ")] 
public DateTime RddTime { get; set; } 


[MYDemo(Description = "计算 折扣 价 ")] 
public double Compute(double q) 
{ 
return q * 0.98d; 
} 
} 
Description 是 MyDemoAttribute 类 的 一 个 公共 属性 ,在 应 用 特性 时 ,可 以 在 括号 中 为 
属性 赋值 。 


注意 : 不 要 把 特性 与 代码 注释 混 消 。 代 码 注 释 虽 然 也 起 着 附加 说 明 的 作用 ,但 是 不 参与 代 
码 编译 。 而 特性 是 一 种 类 , 它 本 身 是 参与 代码 编译 的 ,而 且 可 以 在 代码 中 访问 。 


实例 95 向 特性 类 的 构造 函数 传递 参数 


【导语 】 

特性 类 虽然 用 途 特 殊 , 但 本 质 上 它 也 属于 类 ,因此 也 有 构造 函数 。 如 果 特 性 类 只 有 公共 
的 无 参数 构造 函数 ,那么 在 应 用 时 可 以 忽略 小 括号 ,在 中 括号 中 直接 输入 特性 类 的 名 称 即 
可 。 如 果 特 性 类 有 带 参数 的 构造 函数 ,那么 在 应 用 时 需要 写 上 一 对 小 括号 ,然后 在 小 括号 中 
填 上 参数 (与 普通 构造 函数 的 传 参 方法 一 致 )。 
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例如 ,有 一 个 特性 类 名 为 TestAttribute, 其 中 有 两 个 string 类 型 的 参数 。 在 应 用 该 特 
性 时 应 该 写 为 。 


[Test ( "abc", "def" )] 


如 果 特 性 不 仅 存在 带 参 数 的 构造 函数 ,还 公开 了 属性 成 员 , 那 么 可 以 先 为 构造 函数 传递 
参数 ,然后 再 为 属性 赋值 。 
例如 , 某 个 特性 类 的 声明 如 下 。 


[AttributeUsage( AttributeTargets. Class)] 
class LimitedAttribute:Attribute 
{ 


int _min, _max; 


public LimitedRttribute(int min, int max) 


= min; 


max; 


public int BaseNum { get; set; } 
上 


在 应 用 该 特性 时 ,可 以 先 为 构造 函数 传递 两 个 int 值 , 然 后 再 为 BaseNum 属性 赋值 。 


[Limited(4,6,BaseNum = 1)] 
public class Production 
t 


} 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 自 定义 的 特性 类 。 该 特性 类 可 应 用 于 类 和 结构 ,并 且 带 有 一 个 double 
类 型 参数 的 公开 构造 函数 。 


[AttributeUsage(AttributeTargets. Class | AttributeTargets. Struct)] 
public class DoubleRangeAttribute : Attribute 
{ 

public double Largest { get; } 


public DoubleRangeAttribute( double largest) 
{ 

Largest = largest; 
} 
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步骤 3: 声明 一 个 类 ,并 且 应 用 上 面 定义 的 DoubleRangeAttribute。 


[DoubleRange(700d)] 
public class Test 
{ 


} 


实例 96 在 同一 对 象 上 应 用 多 个 特性 实例 


【导语 】 

在 声明 特性 类 时 ,应 用 的 AttributeUsageAttribute 特性 类 有 一 个 名 为 AllowMultiple 
的 属性 ,用 于 设置 所 声明 的 特性 类 是 否 允许 在 同一 个 代码 对 象 上 应 用 多 个 特性 实例 。 该 属 
性 默认 为 false, 即 在 同一 个 代码 对 象 上 只 能 应 用 一 个 特性 实例 。 

例如 ,ObsoleteAttribute 类 没有 将 AllowMultiple 属性 设置 为 true, 所 以 ,在 下 面 代 码 
中 会 出 现 错误 。 

[Obsolete] 

[Obsolete] 


class Docs 
{ 


} 

尝试 编译 以 上 Docs 类 会 出 现 “ 特 性 重复 ”的 错误 消息 ,因为 Docs 类 上 同时 应 用 了 两 个 
ObsoleteAttribute。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 自 定 义 的 特性 类 。 


AttributeUsage(AttributeTargets. Class, AllowMultiple = true)] 
public class CustomAttribute : Attribute 


public string Ver { get; set; } 


为 了 使 该 特性 支持 多 实例 ,需要 将 AllowMultiple 属性 设置 为 true。 
步骤 3: 声明 一 个 普通 类 ,并 在 该 类 应 用 两 个 CustomAttribute 实例 。 
Custom(Ver = "1.0.0.1"), Custom(Ver = "1.0.2.0")] 


public class AppData 
{ 


如 果 AllowMultiple 属性 的 值 改 为 false 或 保留 默认 值 ,以 上 代码 将 无 法 通过 编译 。 
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实例 97 在 运行 阶段 检索 特性 实例 


【导语 】 

特性 类 的 作用 是 为 代码 对 象 应 用 一 些 辅 助 的 信息 ,因此 在 应 用 程序 运行 阶段 ,可 以 检索 
特性 类 实例 的 相关 数据 ,对 数据 进行 验证 。 

要 实现 在 运行 阶段 检索 特性 ,需要 用 到 反射 技术 , 即 在 运行 时 获取 类 型 以 及 其 成 员 相关 
的 信息 ,然后 再 查找 出 已 应 用 特性 的 对 象 。 

通过 Type 类 可 以 得 到 各 种 代码 对 象 ( 类 、 方 法、 属 性、 字段 等 ) 的 信息 ,它们 的 共同 基 类 
是 MemberInfo ,通过 GetCustomAttribute 扩展 方法 (在 CustomAttributeExtensions 类 中 
定义 ) 可 以 直接 检索 到 已 应 用 的 特性 实例 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 特性 类 ,并 指定 它 只 能 应 用 于 属性 成 员 。 


[AttributeUsage( AttributeTargets. Property)] 
public class MyAttribute : Attribute 
{ 
public char StartChar { get; set; } 
public int MaxLen { get; set; } 
} 


StartChar 属性 用 于 指定 一 个 字符 , 即 规定 目标 属性 值 开 头 的 第 一 个 字符 ; MaxLen 属 
性 用 于 设置 目标 属性 值 的 最 大 字符 串 长 度 。 
步骤 3: 声明 一 个 测试 类 ,并 把 MyAttribute 应 用 到 RawName 属性 上 。 


public class Test 
{ 
[My(StartChar = 'k', MaxLen = 7)] 
public string RawName { get; set; } 
} 


RawName 属性 应 用 MyAttribute 后 ,必须 以 字符 “k” 开 头 限制 它 的 值 ,并 且 长 度 不 能 
到 和 
步骤 4: 在 Program 类 中 声明 一 个 静态 方法 ,在 运行 阶段 验证 Test 对 象 的 属性 值 是 否 
满足 MyAttribute 实例 中 所 设 定 的 限制 。 详 见 代码 清单 4-6。 
代码 清单 4-6 “CheckTest 方法 


static bool CheckTest(Test t, string property) 
{ 

// 获取 类 型 信息 

TYpe type = t.GetType(); 
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// 查找 属性 成 员 

PropertyInfo prop = type. GetProperty (property, BindingFlags. Public | BindingFlags. 
Instance); 

if (prop == null) 

{ 


return false; 


} 
// 获取 特性 
MyAttribute att = prop.GetCustomAttribute< MyAttribute>(); 
// 获取 实例 的 属性 值 
string value = prop.GetValue(t) as string; 
if (string. IsNullOrEmpty(value)) 
return false; 
// 进行 验证 
if (value. StartsWith(att. StartChar) == false) 
return false; 
if (value. Length > att. MaxLen) 
return false; 
return true; 


， 


PropertyInfo 类 表示 与 属性 有 关 的 信息 ,调用 它 的 GetValue 方法 可 以 获取 属性 的 当前 
值 。 将 属性 的 当前 值 与 MyAttribute 实例 中 指定 的 值 进行 比较 ,可 以 验证 属性 值 是 否 符合 
步骤 5: 在 Main 方法 中 实例 化 Test 对 象 ,为 RawName 属性 设 定 一 个 测试 值 。 
Test v = new Test { RawName = "k003d6ex915f" }; 
步骤 6: 调用 CheckTest 方法 对 以 上 Test 实例 的 RawName 属性 进行 验证 。 
bool b = CheckTest(v, nameof(Test. RawName) ) ; 
if (b) 
Console. WriteLine(" 验 证 通过 。"); 
else 
Console. WriteLine(" 验 证 失败 。"); 
虽然 Test 对 象 的 RawName 属性 是 以 字符 “k” 开 头 , 但 是 其 长 度 已 超过 7, 因 此 验证 
失败 。 


实例 98 方法 的 返回 值 如 何 应 用 特性 


【导语 】 

一 般 情况 下 ,特性 会 自动 应 用 到 跟随 其 后 的 对 象 上 。 例 如 要 把 特性 应 用 到 类 上 ,就 将 特 
性 写 在 类 声明 之 前 ; 要 把 特性 应 用 到 属性 上 ,就 将 特性 写 在 属性 声明 之 前 。 如 以 下 代码 
所 示 。 


128 去 | .NET Core 实战 一 一 手把手 教 你 掌握 380 个 精彩 案例 


ComVisible(true) ] 
public class Checker 


[MyCust] 
public int SomeValue { get; set; } 


然而 ,这 种 常规 做 法 并 不 能 将 特性 应 用 到 方法 的 返回 值 上 ,因为 一 般 无 须 在 代码 中 直接 
命名 返回 值 。 这 时 就 要 严格 使 用 特性 的 规范 格式 了 。 应 用 特性 的 规范 格式 如 下 所 示 。 


<target >: <attribute> ] 
其 中 ,< target > 是 特性 要 应 用 的 目标 对 象 ,例如 要 应 用 到 类 上 ,可 以 写 为 以 下 形式 。 
type: SomeAttribute ] 


通常 可 以 省 略 “type:”。 
对 于 方法 的 返回 , 则 必须 将 特性 的 应 用 目标 指定 为 return, 如 下 所 示 。 


return: OtherRttr] 
int TestMethod() { return 0; } 


【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 自 定义 特性 类 ,限定 该 特性 仅 应 用 于 返回 值 。 
[AttributeUsage(RttributeTargets.ReturnValue) ] 

public class CheckSumAttribute : Attribute 


{ 
. 


步骤 3: 在 Program 类 中 添加 一 个 静态 方法 。 
static string SaySomething() => "Hello"; 


步骤 4: 把 上 面 定义 的 CheckSumAttribute 应 用 到 SaySomething 方法 的 返回 值 上 。 


[return: CheckSum] 
static string SaySomething() => "Hello"; 


4.6 运算 符 


实例 99 计算 一 个 整数 的 阶乘 


【导语 】 
本 实例 主要 演示 数学 运算 符 的 使 用 。 常 见 的 数学 运算 符 有 “十 “一 ”“ * ”“/”“% ?等 。 
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阶乘 的 计算 方法 : 假设 要 计算 5 的 阶乘 ,计算 结果 为 1 x*2*3x4x5。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 添加 一 个 Compute 方法 ,传人 一 个 整数 值 ,返回 该 整数 值 的 阶乘 。 


static long Compute( int num) 
{ 
if (num == 0) 
return — 1L; 
long res = 1L; 
int temp = 1; 
while(temp <= num) 
{ 
res = res * temp; 
temp++; 
} 


return res; 
} 
通过 循环 语句 来 完成 阶乘 的 计算 。 声 明 一 个 临时 变量 temp, 初 始 化 为 1, 每 一 轮 循环 
都 将 该 临时 值 与 res 变量 的 值 相 乘 ,然后 将 temp 的 值 增加 1, 直到 temp 的 值 大 于 num 
为 止 。 
步骤 3: 使 用 Compute 方法 计算 4 的 阶乘 。 


longr = Compute(4); 
Console. WriteLine( $ "4 的 阶乘 为 :{r}"); 


步骤 4: 运行 项 目 , 输 出 结果 如 下 。 


4 的 阶乘 为 :24 
实例 100” 按 位 平移 
【导语 】 


运算 符 “<<” 是 将 一 个 数值 的 二 进 制 位 向 左 平移 ,运算 符 “>>” 是 将 之 向 右 平 移 。 例 如 表 
达 式 “10111 >> 2”, 将 数值 10111 的 二 进 制 位 向 右 移 两 位 , 变 成 00101, 后 面 的 两 个 1 在 平移 
时 被 截 掉 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 int 类 型 的 变量 ,用 于 稍 后 做 测试 。 


int x = 305; 
int y = 1060; 
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步骤 3: 将 变量 x 的 二 进 制 位 向 左 移动 3 个 二 进 制 位 。 
WriteLine( $"{Convert. ToString(x, 2)} 向 左 移动 3 位 ,得 到 {Convert. ToString(x << 3, 2)}"); 
步骤 4: 将 变量 y 的 值 向 右 移 动 4 个 二 进 制 位 。 
WriteLine( $ "{Convert.ToString(Y， 2)} 向 右 移动 4 位 ,得 到 {Convert.ToString(y>> 4, 2)}"); 
注意 : Convert. ToString 方法 的 第 二 个 参数 用 于 指定 数值 转换 为 字符 串 后 输出 的 进 制 ,2 
表示 返回 二 进 制 的 字符 事 表 示 形 式 。 
步骤 5: 按 下 快捷 键 F5 运行 项 目 , 控 制 台 窗 口 的 输出 结果 如 图 4-21 所 示 。 


国 CNprogram Files\dotnet\dotnetexe 一 


图 4-21 二 进 制 位 平移 结果 


实例 101 是 “大 ?还 是 “小 ” 

【导语 】 

“? :5 ?是 三 目 运算 符 , 问 号 前 面 是 一 个 必须 返回 布尔 值 的 表达 式 ,如 果 表 达 式 为 
真 ,就 执行 冒号 前 面 的 表达 式 ,否则 就 执行 冒号 后 面 的 表达 式 。 例 如 : 

3 
由 于 1 大 于 3 不 成 立 , 所 以 运算 符 返回 字符 串 * 小 于 ”。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 类 型 的 变量 ,并 进行 初始 化 。 

string s = "abcdefg"; 

步骤 3: 使 用 "? … : …” 运 算 符 对 字符 串 的 长 度 进行 分 析 , 如 果 字符 串 长 度 小 于 或 等 于 
5 则 返回 “字符 串 长 度 不 超过 5”, 否 则 返回 “字符 串 长 度 已 超过 5”。 

string msg = "字符 串 长 度 " + (s.Length<= 5? "不 超过 5”: "已 超过 5"); 

Console. WriteLine(msg); 

步骤 4: 运行 应 用 程序 项 目 , 由 于 字符 串 的 长 度 为 7, 其 值 已 经 大 于 5, 因 此 应 用 程序 输 
出 内 容 如 下 。 


字符 串 长 度 已 超过 5 
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实例 102 typeof 运算 符 的 作用 


【导语 】 

除了 可 以 调用 对 象 实例 的 GetType 方法 来 获取 Type 实例 外 ,还 可 以 使 用 typeof 运算 
符 。 使 用 该 运算 符 的 优点 是 不 需要 事先 创建 类 型 实例 ,直接 将 类 型 名 称 传递 给 运算 符 就 能 
得 到 对 应 的 Type 实例 。 

Type 类 封装 与 某 个 类 型 相关 的 各 种 信息 ,例如 类 型 名 称 、 所 继承 的 基 类 、 是 否 为 泛 型 类 型 
等 。 通 过 Type 类 实例 还 可 以 对 指定 类 型 使 用 反射 技术 ,例如 在 运行 阶段 动态 调用 某 个 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 抽象 类 。 


public abstract class Person 


{ 
public abstract int Age { get; set; } 
} 


步骤 3: 使 用 typeof 运算 符 获 取 该 类 型 相关 的 Type 对 象 。 
Type t = typeof(Person); 
步骤 4: 获取 该 类 型 的 一 些 基本 信息 。 


Console. WriteLine( $ "完整 类 名 :{t. FullName}"); 
Console. WriteLine(" 是 否 为 抽象 类 :{0}", t. IsAbstract ? "是 ”:" 否 "); 
Console. WriteLine(" 是 否 为 公共 类 :{0}",t. IsPublic ?" 是 ”:" 否 "); 


步骤 5: 通过 反射 , 列 出 该 类 型 的 公共 属性 。 


PropertyInfo[ ] props = t.GetProperties(BindingFlags.Public | BindingFlags. Instance); 
Console. WriteLine("\n\n———-—— 属性 列表 ------- Nh 
foreach(var p in props) 
{ 

Console. WriteLine( $ " {p. Name, — 15} {p. PropertyType. Name, 


-15}"); 

. 

PropertyInfo 类 的 Name 属性 可 以 获得 属性 的 名 称 ， 
PropertyType 属性 可 以 返回 该 属性 的 类 型 相关 的 Type 对 象 。 

步骤 6: 按 F5 快捷 键 运行 应 用 程序 项 目 ,输出 结果 如 
图 4-22 所 示 。 图 4-22 输出 类 型 信息 
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实例 103 ”使 用 “十 ”运算 符 将 两 个 对 象 的 属性 值 相 加 


【导语 】 


通过 对 运算 符 重 载 ,开发 人 员 可 以 根据 自己 的 需要 扩展 运算 符 的 功能 。 例 如 本 实例 ,要 


让 “十 ”运算 符 能 够 将 两 个 对 象 实例 的 各 个 


重 载 运算 符 时 要 注意 以 下 几 点 : 
(1) 重 载 的 运算 符 最 好 是 公共 成 员 ,方便 在 类 的 外 部 访问 。 
(2) 重 载 的 运算 符 应 为 静态 成 员 ,因为 运算 符 一 般 是 直接 使 用 的 ,与 特定 的 对 象 实例 关 


系 不 大 。 
(3) 
(4) 


【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 测试 类 ,该 类 公开 两 个 int 类 型 的 属性 。 


class Test 


{ 


public int Vall { get; set; } 
public int Val2 { get; set; } 


} 


步骤 3: 重 载 “十 "运算 符 , 把 参与 计算 的 两 个 操作 数 (Test 类 实例 ) 的 


行 相 加 。 


重 载运 算 符 时 需要 使 用 operator 关键 字 。 
重 载运 算 符 成 员 的 参数 就 是 运算 符 的 操作 数 。 


public static int operator + (Test a Test b) 


{ 


return a.Vall + a.Val2 + b.Vall + b.Val2; 


上 


重 载 后 “十 ”运算 符 的 计算 结果 为 int 类 型 。 
步骤 4: 在 Main 方法 中 ,实例 化 两 个 Test 对 象 。 


Test t1 
Test t2 


new Test { Vall 
new Test { Vall 


5, Val2 
2, Val2 


[ml 


9}; 
6}; 


步骤 5: 使 用 “十 ”运算 符 将 以 上 两 个 变量 进行 相 加 。 


int result = tl + t2; 
Console. WriteLine(" 两 个 对 象 的 属性 值 相 加 结果 :{0}"，result); 


步骤 6: 按 下 快捷 键 F5 运行 应 用 程序 项 目 , 输 出 结果 如 下 。 


两 个 对 象 的 属性 值 相 加 结果 :22 


属性 值 全 部 相 加 ,就 需要 对 “十 "运算 符 进行 重 载 。 


公共 属性 的 值 进 
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实例 104 对 null 进行 判断 

【导语 】 

有 些 时 候 , 在 调用 某 个 类 的 实例 成 员 时 ,必须 先 检查 实例 是 否 为 null。 标 准 的 做 法 如 下 
(假设 d 是 一 个 变量 )。 

if (dl!= null) 


{ 
d. DoSomething( ); 


} 

为 了 让 代码 显得 更 为 简洁 ,在 调用 实例 成 员 时 可 以 在 变量 名 称 后 面 加 上 一 个 “?”( 英 文 
的 问号 ) 运 算 符 ,然后 再 访问 实例 成 员 。 加 上 该 运算 符 后 ,只 有 当 实 例 不 为 null 的 前 提 下 代 
码 才 会 执行 ,否则 就 跳 过 该 行 代码 。 所 以 上 面 的 调用 代码 可 以 简写 为 以 下 形式 。 

d?.DoSomething( ); 


读 取 属 性 值 的 时 候 也 可 以 使 用 以 下 方法 。 


string s = d?.Property; 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 A 类 ,其 中 包含 一 个 Work 方法 。 


class A 


{ 
public void Work() => Console. WriteLine("{0} 方法 被 调用 ."， nameof(Work)); 
} 


步骤 3: 定义 一 个 A 类 型 的 变量 并 赋值 新 的 实例 ,然后 调用 其 Work 方法 。 


Aa = new A(); 
a?. Work(); 


由 于 变量 a 并 不 为 null, 因 此 Work 方法 会 被 调用 。 
步骤 4: 再 用 A 类 声明 一 个 变量 ,初始 化 为 null, 然 后 调用 Work 方法 。 


Ap = null; 
p?. Work(); 


此 时 ,因为 变量 p 为 null, 所 以 Work 方法 不 会 被 调用 。 
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4.7 ”类 型 转换 


实例 105 ”强制 转换 


【导语 】 

强制 转换 一 般 用 在 向 “ 非 兼 容 ” 类 型 转换 的 情形 ,因为 转换 会 导致 数据 损坏 。 例 如 将 
double 类 型 的 数值 转换 为 int 类 型 的 数值 ,由 于 int 只 能 容纳 整数 值 ,这 使 得 double 数值 的 
小 数 部 分 丢失 。 

强制 转换 的 方法 是 在 要 转换 的 对 象 前 使 用 小 括号 ,并 在 小 括号 中 指定 目标 类 型 。 例 如 : 


int k = (int)f; 


上 述 代 码 将 f 变量 的 值 强制 转换 为 int 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 double 类 型 的 变量 a 并 初始 化 ,然后 强制 转换 为 int 类 型 并 赋值 给 变量 b。 
doublea = 5.,10985d; 

int b = (int)a; 

Console. WriteLine( $ "{a, ~ 15}{b, — 15}"); 

强制 转换 后 ,变量 a 的 小 数 部 分 被 丢弃 , 变 为 5。 

步骤 3: 再 声明 double 类 型 的 变量 ,然后 强制 转换 为 int 类 型 并 赋值 给 变量 d。 


double c = 12.8155d; 
int d = (int)c; 
Console. WriteLine( $ "{c, -15}{d, -15}"); 


强制 转换 后 ,变量 c 中 的 小 数 部 分 也 被 丢弃 , 变 为 整 


数 12。 
了 运行 应 用 程序 项 目 ,屏幕 输出 结果 如 图 4-23 。 四 2 加 和 让 全 着 
不 。 


注意 : 并 非 所 有 类 型 之 间 都 能 进行 强制 转换 ,例如 不 存在 继承 关系 的 类 之 间 不 能 转换 、 枚 举 
与 委托 之 间 不 能 进行 转换 等 。 


实例 106 将 int 数值 隐 式 转换 为 double 数值 


【导语 】 
double 类 型 的 数值 包括 整数 部 分 与 小 数 部 分 ,而 int 类 型 的 数值 仅 包 含 整数 部 分 。 当 
int 类 型 的 数值 赋值 给 double 类 型 的 变量 时 ,是 不 需要 强制 转换 的 ,直接 进行 赋值 即 可 , 因 


第 4 章 “面向 对 象 编程 | 其 135 


为 从 int 到 double 之 间 存 在 隐 式 转换 ,转换 之 后 不 会 造成 数据 丢失 。 例 如 ,整数 13 转换 为 
double 类 型 值 会 变 为 13. 000, 数 值 依然 是 13, 不 存在 被 丢弃 的 数据 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 三 个 int 类 型 的 变量 并 进行 初始 化 。 


int x = 28, y = 66, z = 312; 
步骤 3: 声明 三 个 double 类 型 的 变量 ,并 分 别 用 上 面 的 三 个 int 变量 进行 初始 化 。 
doublee = x,f= yg= 2z; 
由 于 此 处 属于 隐 式 转换 ,因此 直接 进行 赋值 即 可 。 
步骤 4: 将 上 面 三 组 数值 输出 到 屏幕 (包括 转换 前 与 转 
换 后 ) 。 


Console. WriteLine( $ "{x, — 15}{e, — 15:0.000}"); 

Console. WriteLine( $ "{y, ~ 15}{f£, ~ 15:0.000}"); 

Console. WriteLine( $ "{z, ~ 15}{g, ~ 15:0.,000}"); 

代码 中 的 “: 0.000” 用 于 设置 输出 字符 串 的 格式 ,0. 000 
表示 保留 三 位 小 数 。 

步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 4-24 所 示 。 图 4-24 数值 间 的 隐 式 转换 结果 


实例 107 输出 整数 的 二 进 制 表 示 形 式 


【导语 】 
Convert 类 公开 了 一 组 可 以 将 整数 数值 转换 为 字符 串 的 方法 : 


string ToString(byte value, int toBase); 

string ToString( int value, int toBase); 

string ToString( long value, int toBase); 

string ToString( short value, int toBase); 

从 上 面 所 列 出 的 方法 来 看 , 受 支 持 的 整数 类 型 有 byte、int、long、short。 所 有 方法 都 有 

-个 toBase 参数 ,该 参数 为 一 个 int 类 型 的 值 。 作 用 是 指定 整数 值 转换 为 字符 串 后 所 呈现 

的 进 制 形 式 。 所 以 toBase 参数 的 值 是 不 可 以 随意 指定 的 ,有 效 值 为 2.8、10、16, 分 别 对 应 二 
进 制 , 八 进 制 .十进制 和 十 六 进 制 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 四 个 变量 ,类 型 分 别 为 byte、int、long、short。 


byte vl = 155; 
int v2 = 916652; 
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long v3 = 1200365172; 
short v4 = 5185; 


步骤 3: 使 用 Convert. ToString 方法 将 以 上 四 个 变量 的 值 转换 为 二 进 制 字符 串 ,并 输 
出 到 控制 台 窗口 中 。 

Console. WriteLine( $ "{v1, - 15}{Convert. ToString(v1, 2), ~ 80}"); 

Console. WriteLine( $ "{v2, — 15}{Convert. ToSstring(v2, 2), - 80}"); 


Console. WriteLine( $ "{v3, - 15}{Convert. ToString(v3, 2), - 80}"); 
Console. WriteLine( $ "{v4, — 15}{Convert. Tostring(v4, 2), - 80}"); 


步骤 4: 运行 应 用 程序 项 目 ,输出 结果 如 图 4-25 所 示 。 


图 4-25 输出 整数 值 的 二 进 制 形式 


实例 108 ”将 字 节 数组 转换 为 字符 串 


【导语 】 

BitConverter 类 是 有 特定 用 途 的 类 型 转换 辅助 类 , 它 主 要 完成 基础 类 型 与 字 节 数组 之 
间 的 转换 操作 。 其 中 , ToString 方法 可 以 将 一 个 字 节 数组 转换 为 单个 字符 串 实例 ,数组 中 
的 每 字 节 均 输 出 为 两 位 十 六 进 制 数 , 字 节 与 字 节 之 间 用 字符 “- "连接 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字 节 数组 ,并 进行 初始 化 。 


byte[ ] buffer = { 3, 12, 5, 92, 7, 61, 18, 53, 135 }; 
步骤 3: 调用 BitConverter. ToString 方法 ,获得 转换 后 的 字符 串 。 


string str = BitConverter.ToString(buffer); 
Console. WriteLine( str); 


步骤 4: 运行 应 用 程序 项 目 , 将 看 到 以 下 输出 结果 。 


03-00=05=506—01—39= 12=35=@87 
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实例 109 重 写 ToString 方法 


【导语 】 

Object 类 包含 一 个 虚 方 法 一 一 ToString。 由 于 Object 是 各 种 数据 类 型 的 基 类 ,因此 类 
型 编写 者 可 以 重 写 ToString 方法 ,以 便 能 够 自 定义 类 型 的 字符 串 表示 形式 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 Production 类 ,并 公开 一 些 属性 。 


public class Production 
{ 
public int ID { get; set; } 
public int Width { get; set; } 
public int Height { get; set; } 
public string SerialNum { get; set; } 
E 


步骤 3: 在 Production 类 中 重 写 ToString 方法 ,返回 自 定义 字符 串 ,字符 串 可 以 由 该 类 
的 属性 值 组 成 。 


public class Production 
{ 


public override string ToString() 
{ 
return $ "产品 序列 号 :{SerialNum} ,规格 (厘米 ):{Width} x {Height}"; 
} 
} 


步骤 4: 在 Main 方法 中 实例 化 一 个 Production 数组 。 


Production[ ] prs = 
{ 


new Production 


{ 


ID = 1， 
Width = 150, 
Height = 70, 


SerialNum = "T 一 312756 一 K3"” 
}, 
new Production 
{ 
De= 2, 
Width = 200 
Height = 8! 
SerialNum = "T— 33158—K7" 


’ 
7 


}， 
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new Production 


ID=3, 
Width = 210, 
Height = 75, 


SerialNum = "T 一 23158 一 K8" 


new Production 


ID = 4 
Width = 270, 
Height = 56, 


SerialNum = "T— 600001— C4" 


new Production 


{ 


ID = 5, 
Width = 260, 
Height = 90, 


SerialNum = "T—712558— C7" 


3 
}; 


步骤 5: 调 
形式 输出 到 窗 上 


用 Console. WriteLine 方法 将 数组 中 的 每 个 Production 对 象 的 字符 串 表示 
1 上 ,WriteLine 方法 会 自动 调用 实例 的 ToString 方法 。 


foreach (Production p in prs) 


{ 


Console. WriteLine(p); 


} 


步骤 6: 按 下 F5 快捷 键 运行 应 用 程序 项 目 ,屏幕 输出 结果 如 图 4-26 所 示 。 


Ci\Program Files\dotnet\dotnet.exe 口 x 
T-312756-K 
T33158 
T 
I 
T 


图 4-26 调用 ToString 方法 输出 自 定义 字符 串 


实例 110 ”将 整数 转换 为 十 六 进 制 字符 串 


【导语 】 


许多 基础 类 型 都 公开 可 以 设置 格式 参数 的 ToString 方法 ,支持 使 用 格式 化 字符 串 来 确 
定 要 返回 的 字符 串 格式 。 例 如 ToString(*N”) 可 以 将 数值 以 常规 数据 格式 返回 , 即 每 隔 三 
位 就 有 一 个 英文 的 逗号 , 形 如 23,355,456. 22。 
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十 六 进 制 字符 串 的 格式 符号 为 “x”, 如 果 字 符 串 为 大 写 ( 即 “X”), 则 返回 的 十 六 进 制 格 


式 品 


将 以 大 写字 母 来 呈现 , 即 A、B、C、D、E、F。 格 式 符号 后 有 时 候 可 以 跟 一 个 数字 2, 表 示 


使 用 两 位 数 来 描述 一 字 节 ,例如 3 的 “X2? 格 式 将 返回 “03”,255 的 “X2” 格 式 则 返回 “FF”。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 int 类 型 的 变量 并 初始 化 。 


int x = 91545588; 

步骤 3: 输出 该 变量 的 十 六 进 制 形式 。 

Console. WriteLine("{0} -> 0xf1j"，xy x.ToString("x2")); 
步骤 4: 运行 应 用 程序 项 目 ,输出 结果 如 下 。 


91545588 一 > 0x574dff4 


实例 111 自 定义 隐 式 转换 


【导语 】 
在 默认 情况 下 ,不 同类 型 之 间 是 无 法 进行 转换 的 ,尤其 是 引用 类 型 与 值 类 型 之 间 更 不 可 


能 进行 转换 。 但 是 ,为 了 便于 开发 者 实现 一 些 特殊 的 转换 ,语言 规范 允许 使 用 类 似 运算 符 重 
载 的 方式 来 实现 自 定义 的 转换 。 书 写 格式 如 下 。 


public static implicit operator < 返回 的 类 型 > ( < 待 转换 的 类 型 > ) {…}) 
public static explicit operator < 返回 的 类 型 > ( < 待 转换 的 类 型 > ) { …} 


implicit 关键 字 表 示 隐 式 转换 ,explicit 关键 字 表 示 显 式 转换 。 两 者 的 不 同 在 于 : 隐 式 


转换 通过 赋值 可 以 自动 完成 转换 ,例如 派生 类 的 实例 可 以 直接 赋值 给 用 基 类 声明 的 变量 ; 
显 式 转换 需要 强制 转换 ,例如 double 类 型 的 值 要 赋值 给 int 类 型 的 变量 ,就 需要 在 赋值 时 进 
行 强制 转换 。 


本 实例 将 演示 从 自 定义 类 到 int 类 型 的 隐 式 转换 。 

【操作 流程 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 类 ,表示 一 个 矩形 的 相关 信息 ,其 中 包含 矩形 的 宽度 和 高 度 。 


public class RectArea 
{ 
public Rectarea( int width, int height) 
' 
Width = width; 
Height = height; 
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public int Width { get; } 
public int Height { get; } 


} 
步骤 3: 为 了 通过 隐 式 转换 来 获得 矩形 的 面积 ,需要 在 RectArea 类 中 添加 自 定义 转换 
的 实现 。 


public class RectArea 
{ 


public static implicit operator int(RectArea r) 


{ 


return r. Width * r.Height; 


} 


注意 : 自 定义 的 转换 需要 声明 为 静态 成 员 , 因 为 转换 是 面向 类 型 的 ,而 不 是 面向 对 象 实 
例 的 。 


步骤 4: 在 Main 方法 中 实例 化 RectArea 对 象 。 
RectArea v = new RectArea(12, 15); 

步骤 5: 声明 int 类 型 的 变量 ,并 直接 将 RectArea 实例 赋值 给 它 
int area = vi 

步骤 6: 输出 矩形 的 属性 及 其 面积 。 


Console. WriteLine( $ "矩形 信息 :\n 宽 :{v.Width}\n 高 :{v. Height}\ 
n 面积 :{area}"); 


步骤 7: 运行 应 用 程序 项 目 , 控 制 台 窗口 输出 结果 如 图 4-27 
所 示 。 


4.8 可 以 为 null 的 值 类 型 


图 4-27 ”输出 矩形 面积 


实例 112 访问 可 以 为 null 的 值 类 型 

【导语 】 

允许 值 类 型 为 null 的 主要 应 用 场景 是 面向 数据 库 的 编程 ,因为 数据 表 的 字段 都 可 能 为 
null。 当 数据 模型 类 与 数据 库 对 象 映射 时 ,模型 类 公开 的 属性 值 就 可 以 使 用 为 null 的 值 
类 型 。 
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声明 可 以 为 null 的 值 类 型 变量 时 ,有 两 种 方法 : 

第 一 种 是 直接 使 用 . NET 类 型 Nullable< 工 >, 例 如 以 下 形式 。 

Nullable<byte>b = null; 

第 二 种 是 使 用 C# 语 言 的 特定 语法 ,例如 以 下 形式 。 

byte? b = null; 

在 运行 阶段 ,以 上 两 种 方法 所 声明 的 变量 类 型 相同 。 

要 获取 Nullable < 下 > 类 型 实例 的 值 ,可 以 访问 Value 属性 。 由 于 Nullable < T > 类 型 
的 变量 值 有 可 能 为 null, 因 此 最 好 不 要 直接 访问 Value 属性 ,而 是 先 检查 一 下 HasValue 属 
性 是 否 为 true, 如 果 为 true 说 明 存 在 有 效 值 ,否则 就 为 null。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 可 以 为 null 的 int 类 型 变量 并 初始 化 为 null。 


int? x = null; 
步骤 3: 检索 变量 x 中 的 值 。 


if (x.HasValue) 

Console. WriteLine(" 变 量 x 的 值 为 :{0}。", x. Value); 
else 

Console. WriteLine(" 变 量 x 为 nu11,."); 


步骤 4: 再 声明 一 个 可 以 为 null 的 double 类 型 的 变量 ,初始 化 时 分 配 一 个 有 效 的 值 。 
double? y = 91.3d; 
步骤 5: 检索 变量 y 中 的 值 。 


if (Y.HasValue) 
Console. WriteLine(" 变 量 y 的 值 为 :{0}。",y. Value) ; 
else 
Console. WriteLine(" 变 量 Y 为 null。"); 
步骤 6: 运行 应 用 程序 项 目 , 程 序 输出 结果 如 图 4-28 
所 示 。 


实例 113 ”为 Nullable <T> 实 例 分 配 默认 值 


【导语 】 

在 获取 Nullable < T > 实例 的 值 时 ,如 果 每 次 都 检查 HasValue 属性 会 很 麻烦 ,此 时 可 
以 考虑 当 实 例 为 null 时 自动 返回 一 个 默认 值 。 

假设 变量 a 是 Nullable < int > 类 型 实例 ,在 获取 int 值 时 如 果 为 null 就 返回 默认 值 5。 


4-28 ”输出 Nullable 
<T> 实 例 的 值 
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语法 如 下 。 
int val = a?? 5; 


这 个 运算 符 由 两 个 英文 的 问号 组 成 。 如 果 变 量 a 不 为 null, 就 返回 变量 a 的 实际 值 ; 如 
果 变 量 a 为 null, 就 返回 “??? 后 面 的 内 容 , 即 数值 5。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Nullable < int > 类 型 的 变量 ,初始 化 为 null。 


int? c = null; 
步骤 3: 通过 “??” 运 算 符 获取 变量 c 的 值 ,如 果 为 null, 默 认 返 回 25。 
intr = c?? 25; 


因为 变量 c 初始 化 时 分 配 为 null, 因 此 赋值 后 变量 r 的 值 是 25。 
步骤 4: 再 声明 一 个 Nullable < int > 类 型 的 变量 ,这 次 给 它 分 配 一 个 有 效 值 。 


int? d = 100; 
步骤 5: 获取 变量 d 的 值 ,存储 到 变量 s 中 。 
ints = d??8; 


变量 d 中 包含 有 效 值 100, 赋 值 后 变量 s 的 值 为 100, 而 不 是 8。 


数学 运算 与 字符 串 处 理 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 简单 数学 计算 ; 

。 日 期 /时 间 换 算 ; 

。 和 常用 的 字符 串 处 理 ; 

。 格 式 控制 符 ; 

。 从 字符 串 到 其 他 类 型 的 转换 。 


5.1 简单 数学 计算 


实例 114 求 一 组 整数 中 的 最 大 值 和 最 小 值 

【导语 】 

一 组 整数 (主要 是 int 类 型 ) 可 以 用 int 数组 来 存储 ,也 可 以 用 List < int > 类 来 存储 。 要 
一 次 性 计算 出 一 组 数值 中 的 最 大 值 与 最 小 值 ,可 以 借助 一 个 辅助 类 一 一 Enumerable( 位 于 
System. Linq 命名 空间 下 ) ,该 类 提供 了 许多 扩展 方法 ,可 以 对 集合 、 列 表 、 数 组 中 的 元 素 进 
行 各 种 计算 与 处 理 。 本 例 将 使 用 Max 方法 和 Min 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 代码 文件 顶部 引入 以 下 命名 空间 。 


using System. Ling; 
步骤 3: 声明 一 个 int 数组 ,并 用 一 些 整 数值 进行 初始 化 。 

int[] srcarr = { 102, 45, 17, 325, 6, 199, 207, 416, 736, 94, 27 }; 
步骤 4: 调用 Max 方法 筛选 出 数组 中 的 最 大 值 。 

Console. WriteLine( $ "\n 其 中 ,最 大 的 数 为 :{srcarr.Max()}"); 

步骤 5: 调用 Min 方法 筛选 出 最 小 值 。 
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Console. WriteLine( $ "最 小 的 值 为 :{srcarr. Min()}"); 


步骤 6: 按 下 F5 快捷 键 运行 ,输出 结果 如 图 5-1 所 示 。 


5-1 输出 最 大 值 与 最 小 值 


实例 115 “计算 平均 值 


【导语 】 

Average 扩展 方法 可 用 于 计算 一 个 数值 序列 的 平均 值 ,支持 的 输入 类 型 有 int、long、 
float、double。 而 计算 结果 通常 返回 float( 单 精度 数值 ) 或 double( 双 精度 数值 ) 两 种 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 double 类 型 的 数组 ,并 进行 初始 化 。 


double[ ] src = 


{ 
20.55d, 4.7d, 0.92d, 5.886d, 110.6d 
CNprogramfile。 一 0O x 
}; 性 计算 序 旬 ， 
步骤 3: 计算 以 上 数组 中 所 有 元 素 的 平均 值 , 并 输出 天 
到 控制 台 窗 口中 。 


Console. WriteLine( $ "其 平均 值 为 :{src. Average( )}"); 


步骤 4; 运行 应 用 程序 项 目 ,其 输出 的 平均 值 如 图 5-2 图 5 2 求 得 数组 的 平均 值 


所 示 。 
实例 116 ”计算 一 个 数值 的 绝对 值 
【导语 】 


Math 类 提供 与 数学 运算 相关 的 一 系列 静态 方法 ,可 以 直接 调用 ,包括 求 绝对 值 . 求 最 
大 或 最 小 值 三 角 函 数 .指数 宕 等。 

本 实例 将 使 用 Abs 方法 返回 输入 数值 的 绝对 值 ,支持 的 输入 类 型 有 : 整数 . 单 精度 小 
数 、 双 精度 小 数 以 及 有 符号 字 节 。 
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【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 代码 文件 中 使 用 using static 指令 引入 Math 类 。 由 于 该 类 是 静态 类 ,引入 后 
可 以 在 代码 中 直接 访问 其 公共 方法 ,而 无 须 输入 类 名 。 


using static System. Math; 


步骤 3: 声明 四 个 变量 ,用 于 稍 后 做 测试 。 


double nl = -3.0112d; 
int n2 = 9060; 
float n3 = —15.3f; 


decimal n4 = 417.63M; 


步骤 4: 调用 Abs 方法 计算 以 上 四 个 变量 值 的 绝对 值 ， 
并 输出 到 控制 台 窗口 中 。 


WriteLine( $"{n1} 的 绝对 值 = {Abs(n1)}"); 
WriteLine( $"{n2} 的 绝对 值 = {Abs(n2)}"); 
WriteLine( $ "{n3} 的 绝对 值 = {Abs(n3)}"); 
WriteLine( $ "{n4} 的 绝对 值 = {Abs(n4)}"); 图 $-3 四 个 数值 的 绝对 值 


步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-3 所 示 。 
实例 117 计算 一 个 矩形 序列 的 周 长 总 和 


【导语 】 

计算 一 个 矩形 的 周 长 , 需 要 将 相 邻 的 两 条 边 长 相 加 再 乘 以 2。 本 实例 同时 也 将 使 用 
Enumerable 类 的 Sum 扩展 方法 ,以 计算 所 有 和 矩形 的 周 长 总 和 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 System. Linq 命名 空间 。 


using System. Ling; 
步骤 3: 声明 一 个 Rectangle 结构 ,用 以 封装 矩形 的 宽度 与 高 度 。 


struct Rectangle 
{ 
public float Width; 
public float Height; 
} 


步骤 4: 在 Main 方法 中 声明 一 个 Rectangle 数组 ,并 使 用 4 个 Rectangle 实例 进行 初始 化 。 


Rectangle[ ] rects = 
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new Rectangle{ Width = 16.3f, Height I 
new Rectangle{ Width 24.5f, Height WE}, 
new Rectangle{ Width 9.6f, Height = 8.5f }, 
new Rectangle{ Width = 4f, Height = 12.3f } 


}; 

步骤 5: 计算 这 些 和 矩形 的 周 长 之 和 。 

float lens = rects.Sum(r => (r.Width + r.Height) * 2f); 

Sum 方法 中 使 用 了 一 个 委托 ,在 计算 总 和 的 时 候 ,Sum 方法 会 把 每 个 元 素 ( 此 处 是 
Rectangle 实例 ) 都 传递 到 这 个 委托 ,并 获取 计算 出 来 的 局 部 结果 ,再 把 所 有 的 局 部 结果 进行 
相 加 ,以 确定 最 终 的 值 。 在 该 委托 中 ,应当 返 回 单个 矩形 的 周 长 。 

步骤 6: 运行 应 用 程序 ,输出 如 下 结果 。 

以 上 4 个 矩形 的 周 长 总 和 为 :184.4 


实例 118 ” 求 某 个 角度 的 正弦 值 

【导语 】 

Math 类 提供 了 计算 三 角 函 数 的 相关 方法 。 例 如 ,Sin 方法 可 用 于 计算 正弦 值 ,Cos 方法 
可 用 于 计算 余弦 值 等 。 

不 过 ,这 些 方法 的 输入 参数 皆 为 弧度 角 ,而 人 们 习惯 使 用 角度 值 ,因此 在 传递 参数 的 时 
候 , 需 要 使 用 以 下 换算 公式 将 角度 值 转换 为 弧度 角 。 


弧度 角 一 角度 值 Xj85 
圆周 率 (x) 的 值 可 以 访问 Math 类 的 PI 常量 获取 。 
【操作 流程 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 分 别 计算 15"、.30"、45"、60".90* 的 正弦 值 。 


Console. WriteLine( $ "15 度 的 正弦 值 :{Math. Sin(15 * Math.PI / 180)}"); 
Console. WriteLine( $ "30 度 的 正弦 值 :{Math. Sin(30 * Math.PI / 180)}"); 
Console. WriteLine( $ "45 度 的 正弦 值 : {Math. Sin(45 * Math.PI / 180)}"); 
Console. WriteLine( $ "60 度 的 正弦 值 : {Math. Sin(60 * Math.PI / 180)}"); 
Console. WriteLine( $ "90 度 的 正弦 值 :{Math. Sin(90 * Math.PI / 180)}"); 


在 调用 Sin 方法 的 时 候 , 要 将 角度 转换 为 弧度 角 。 
以 30 度 为 例 ,将 角度 值 先 乘 以 Math. PI, 再 除 以 180。 


30 * Math.PI / 180 


步骤 3: 运行 应 用 程序 项 目 , 输 出 结果 如 图 5-4 
所 示 。 


图 5-4 各 角度 值 的 正弦 值 
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实例 119 求 某 个 数值 的 立方 


【导语 】 

Math 类 的 Pow 方法 的 功能 是 震 运 算 ,其 中 ,参数 x 为 底数 ,参数 y 为 指数 。 要 求 得 某 
个 数值 的 立方 ,只 需要 向 y 参数 传递 3 即 可 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 double 类 型 的 数组 ,数组 中 的 元 素 为 需 
要 进行 客运 算 的 底数 。 

double[ ] srcnums = { 5d, 3d, 7d, 4d, 6d }; 


步骤 3: 通过 foreach 循环 访问 数组 中 的 元 素 , 并 对 每 个 
元 素 都 进行 指数 为 3 的 宕 运算 ( 即 求 立方 值 ) 。 
foreach(double d in srcnums) 


{ 


Console. WriteLine("{0} 的 立方 为 :{1j\n"， dy Math.Pow(d, 3d)); 图 5-5 输出 各 数值 的 立方 值 


步骤 4: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-5 所 示 。 

实例 120 “计算 矩形 的 对 角 线 长 度 

【导语 】 

由 于 矩形 的 四 个 角 都 是 直角 ,并 且 相对 的 两 条 边 长 度 相同 ,这 使 得 相 邻 两 条 边 与 对 角 线 
可 以 构成 一 个 直角 三 角形 。 因 此 可 以 运用 勾 股 定理 计算 出 对 角 线 的 长 度 。 

假设 w 表示 和 矩形 的 宽度 ,h 表示 矩形 的 高 度 ,d 表示 对 角 线 的 长 度 。 那么 , 求 对 角 线 长 
度 的 公式 如 下 。 

本 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 Rectangle 类 ,包含 与 矩形 相关 的 属性 ,例如 宽度 与 高 度 。 


class Rectangle 


{ 
public Rectangle( double w, double h) 
{ 
Width = w; 
Height = h; 
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public double Width { get; } 
public double Height { get; } 
} 


步骤 3: 在 Rectangle 类 中 添加 一 个 Diagonal 属性 ,返回 对 角 线 的 长 度 。 


class Rectangle 


{ 


public double Diagonal 
{ 
get 
{ 
// 分 别 计算 宽度 与 高 度 的 平方 
double qw = Math.Pow(Width, 2d); 
double qh = Math.Pow(Height, 2d); 


// 将 qw 与 qh 相 加 ,再 获取 算术 平方 根 
double res = Math. Sqrt(qw + qh); 
return res; 


} 


首先 调用 Pow 方法 分 别 算出 Width 属性 和 Height 属性 的 平方 ,然后 将 两 个 值 相 加 ,并 
调用 Sqrt 方法 开平 方 根 ,最 后 返回 对 角 线 的 长 度 。 

步骤 4: 在 Main 方法 中 初始 化 Rectangle 对 象 。 

Rectangle rect = new Rectangle(6d, 10d); 

步骤 5: 在 控制 台中 输出 矩形 的 对 角 线 长 度 。 

string message = $ "宽度 : {rect. Width} \n 高 度 : {rect. 


Height}\n 对 角 线 长 度 :{rect. Diagonal:N2}"; 
Console. WriteLine(message); 


步骤 6: 运行 应 用 程序 项 目 ,输出 的 对 角 线 长 度 如 图 5-6 图 5.6 输出 矩形 的 对 角 线 长 度 
所 示 。 


实例 121 ”处 理 超 大 整数 

【导语 】 

在 常用 的 整数 类 型 中 ,容量 最 大 的 是 64 位 整数 。 但 是 ,在 一 些 特定 的 应 用 场景 中 ,应 用 
程序 需要 存储 的 整数 值 会 远 远 超过 64 位 整数 的 最 大 值 (例如 ,两 个 64 位 整数 相 乘 ) 。 这 时 
候 , 就 需要 用 到 超大 整数 类 型 一 一 BigInteger( 位 于 System. Numerics 命名 空间 ) 。 

BigInteger 类 型 的 整数 没有 限定 最 大 值 和 最 小 值 ,也 就 是 说 ,理论 上 它 可 以 存储 无 限 大 
的 整数 。 然 而 受到 计算 机 内 存 的 限制 ,很 难 真正 做 到 “无 限制 大 ”。 当 BigInteger 耗 尽 可 用 


内 存 时 ,就 会 她 出 OutOfMemoryException 异常 。 

本 实例 将 使 用 BigInteger 实例 来 存放 整数 300 的 阶乘 运算 结果 ,因为 其 结果 已 远 远 超 
出 64 位 整 的 容量 ,只 能 使 用 BigInteger 类 型 存储 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 计算 300 的 阶乘 ,使 用 BigInteger 对 象 来 保存 结果 。 

intn = 300; 


BigInteger bi = 1; 
int temp = n; 


while(temp > 0) 

{ 
bi * = temp; 
temp——; 


} 
步骤 3: 将 计算 结果 输出 到 屏幕 。 
Console. WriteLine("{0} 的 阶乘 :\n{1}", n, bi); 


步骤 4: 运行 应 用 程序 项 目 ,屏幕 输出 结果 如 图 5-7 所 示 。 


图 5-7 300 的 阶乘 


5.2 日 期 /时 间 换 算 


实例 122 今天 是 星期 几 


【导语 】 

与 日 期 /时 间 有 关 的 数据 由 DateTime 结构 封装 。 其 中 ,DayOfWeek 属性 可 以 获取 某 
个 日 期 是 一 周 中 的 哪 一 天 ,属性 返回 DayOfWeek 枚 举 值 , 该 枚 举 类 型 明确 定义 了 从 星期 日 
到 星期 六 , 共 7 个 常量 值 。 
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访问 静态 属性 Today 可 以 获取 当前 日 期 ,再 访问 DayOfWeek 属性 可 以 知道 今天 是 星 
期 几 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Main 方法 中 ,定义 一 个 DateTime 类 型 的 变量 ,并 获取 今天 
的 日 期 。 


DateTime today = DateTime. Today; 

步骤 3: 访问 DayOfWeek 属性 。 

var weekday = today. DayOfWeek; 

步骤 4: 通过 switch 语句 确定 要 输出 的 内 容 。 


string msg = "今天 是 "; 
Switch (weekday) 
{ 
case DayOfWeek. Sunday: 
msg += "星期 天 "; 
break; 
case DayOfWeek. Monday: 
msg += "星期 一 "; 
break; 
case DayOfWeek. Tuesday: 
msg += "星期 二 "; 
break; 
case DayOfWeek. Wednesday: 
msg += "星期 三 "; 
break; 
case DayOfWeek. Thursday: 
msg += "星期 四 "; 
break; 
case DayOfWeek. Friday: 
msg += "星期 五 "; 
break; 
case DayOfWeek. Saturday: 
msg += "星期 六 "; 
break; 
} 
Console. WriteLine(msg); 


步骤 5: 运行 应 用 程序 项 目 后 ,屏幕 上 就 会 输出 当前 日 期 在 一 周 中 的 位 置 ,如 “今天 是 星 
期 三 ”。 
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实例 123 ”获取 指定 日 期 的 农历 日 期 

【导语 】 

农历 是 中 国 传统 历法 ,属于 阴阳 历 ( 并 非 纯 阴历 ). 用 月 相 ( 朔 望月 ) 确 定 每 月 周期 ,并 依 
据 太阳 年 (回归 年 ) 设 置 二 十 四 节气 。 平 年 为 十 二 个 月 ,周年 为 十 三 个 月 ,大 月 三 十 天 ,小 月 
二 十 九天 (朔望月 平均 长 度 为 29. 530588 天 ) 。 

为 了 方便 获取 与 农历 相关 的 信息 ,在 System. Globalization 命名 空间 下 ,提供 了 一 个 专 
门 用 于 计算 中 国 农历 的 ChineseLunisolarCalendar 类 ,该 类 从 EastAsianLunisolarCalendar 
类 派生 (因为 东亚 国家 的 历法 与 农历 有 相似 之 处 ,例如 表示 日 本 历法 的 JapaneseCalendar 类 ) 。 

要 获取 指定 日 期 在 农历 中 的 日 期 ,可 以 分 别 调用 GetMonth 和 GetDayOfMonth 两 个 方 
法 ,两 个 方法 均 返 回 int 数值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Globalization; 

步骤 3: 实例 化 ChineseLunisolarCalendar 对 象 。 
ChineseLunisolarCalendar cncld = new ChineseLunisolarCalendar(); 
步骤 4: 定义 三 个 使 用 公历 表示 的 日 期 ,用 于 稍 后 测试 。 


DateTime dl 
DateTime d2 
DateTime d3 


步骤 5: 获取 以 上 三 个 日 期 的 农历 日 期 (包括 月 与 日 )。 


Console. WriteLine( $"{dl:d}, 农 历 :{cncld. GetMonth(d1)} 月 {cncld. GetDayOfMonth(d1)} 日 "); 
Console. WriteLine( $"{d2:d}, 农 历 :{cncld. GetMonth(d2)} 月 {cncld. GetDayOfMonth(d2)} 日 "); 
Console. WriteLine( $"{d3:d}, 农 历 :{cncld. GetMonth(d3)} 月 {cncld. GetDayOfMonth(d3)} 日 "); 


步骤 6: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-8 所 示 。 


new DateTime(2017, 12, 18); 
new DateTime(2018, 3, 20); 
new DateTime(2018, 5, 15); 


图 5-8 输出 指定 日 期 的 农历 


注意 : 由 于 2017 年 存在 头 六 月 (数值 为 7) ,因此 ,农历 12 月 13 日 , 实 为 11 月 13 日 。 
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实例 124 一 天 内 总 共有 多 少 秒 

【导语 】 

DateTime 结构 所 表示 的 是 某 个 特定 的 时 间 点 ,而 TimeSpan 结构 则 可 以 表示 一 个 时 间 
段 , 它 描述 的 是 时 间 区 域 ,例如 一 首 乐曲 总 时 长 为 00: 03: 47, 这 就 要 使 用 TimeSpan 来 
表示 。 

TimeSpan 结构 定义 有 Day、Hours、Minutes、Seconds 等 属性 ,用 于 获取 时 间 段 中 各 部 
分 的 值 , 例 如 上 面 提 到 的 00: 03: 47 ,那么 ,其 Hours 属性 的 值 为 0,Minutes 属性 的 值 为 3， 
Seconds 属性 的 值 为 47 。 

与 这 些 属性 相对 应 的 ,还 有 带 前 级 Total 的 属性 , 如 TotalHours、TotalMinutes、 
TotalSeconds 等 。 这 些 属 性 获取 的 是 总 值 ,如 上 面 的 00: 03: 47, 它 的 TotalHours 属性 的 
值 为 0.063,TotalSeconds 属性 的 值 为 227, 即 它 的 总 秒 数 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 TimeSpan 结构 ,时 间 段 为 24 小 时 。 


TimeSpan s = new TimeSpan(24, 0, 0); 

步骤 3: 从 TotalSeconds 属性 可 以 获取 总 秒 数 。 
string str = $ "一 天 内 总 共有 {s. TotalSeconds} 秒 ,"; 
步骤 4: 再 创建 一 个 TimeSpan 实例 ,初始 化 时 间 段 为 3 天 (72 小 时 ) 。 
s = new TimeSpan(3, 0, 0, 0); 

步骤 5: 获取 3 天 时 间 内 的 总 秒 数 。 


str = $ "三 天 内 总 共有 {s.TotalSeconds} 秒 。"; 


1 CPro. 一 口 x 


步骤 6: 运行 应 用 程序 项 目 ,输出 内 容 如 图 5-9 所 示 。 图 5-9 输出 总 秒 数 
实例 125 日 期 的 加 / 减 运 
【导语 】 


DateTime 结构 提供 了 几 个 以 Add 开头 的 方法 ,如 AddYears、AddMonths、AddDays 
等 ,这 些 方 法 可 以 对 日 期 /时 间 进 行 加 法 或 者 减法 运算 。 

如 果 传 递 给 参数 的 值 是 正 值 ,表示 时 间 向 后 推移 ; 如 果 是 负 值 , 则 表示 时 间 向 前 推移 。 
例如 ,AddMonths (2) 表示 两 个 月 之 后 的 日 期 ,AddMonths( 一 2) 则 表示 两 个 月 前 的 日 期 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 初始 化 一 个 日 期 /时 间 ,用 于 后 面 做 运算 测试 。 


DateTime dl = new DateTime(2018, 4, 1); 

步骤 3: 计算 6 天 后 的 日 期 ,传递 给 AddDays 方法 参数 的 值 
为 6。 

DateTime d2 = dl.AddDays(6d); 

步骤 4: 计算 3 天 前 的 日 期 ,传递 给 AddDays 方法 参数 的 值 
为 一 和 


图 5-10 日 期 加 /减法 


计算 结果 
DateTime d3 = dl.AddDays( — 3d); 
步骤 5: 运行 应 用 程序 项 目 ,输出 内 容 如 图 5-10 所 示 。 
实例 126 ”从 日 期 字符 串 中 产生 DateTime 实例 
【导语 】 


DateTime 结构 有 一 个 名 为 Parse 的 静态 方法 ,该 方法 会 对 传 入 的 字符 串 进行 分 析 , 如 
果 字 符 串 表示 的 是 有 效 的 日 期 /时 间 ,Parse 方法 会 返回 一 个 DateTime 实例 ,并 将 从 字符 串 
中 识别 出 来 的 数据 填充 到 该 DateTime 实例 中 ; 但 如 果 分 析 失 败 就 会 她 出 异常 。 若 希望 避 
免 抛 出 异常 ,可 以 使 用 TryParse 方法 ,该 方法 不 会 抛 出 异常 ,但 是 如 果 对 字符 串 的 分 析 失 败 
就 会 返回 false ,如果 成 功 就 返回 true 

用 于 进行 日 期 /时 间 分 析 的 字符 串 一 定 要 符合 标准 日 期 /时 间 格 式 的 要 求 ,可 以 在 
Windows 系统 的 日 期 和 时 间 设 置 中 获取 参考 信息 ,如 图 5-11 所 示 。 


在 任务 栏 中 显示 其 他 日 历 


长 时 间 : 
更 改 日 期 和 时 间 格 式 


图 5-11 Windows 系统 中 的 标准 日 期 与 时 间 格 式 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 字符 串 类 型 的 变量 并 初始 化 , 稍 后 将 用 它 分 析 日 期 /时 间 。 
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string ds =" 2018 年 5 月 20 日 23:14:20"; 
步骤 3: 调用 Parse 方法 对 字符 串 进行 分 析 , 以 产生 新 的 DateTime 实例 。 


DateTime dt = DateTime.Parse(ds); 


步骤 4: 输出 新 产生 的 DateTime 实例 的 相关 属性 ,以 验证 字符 串 是 否 分 析 成 功 。 


string msg = $"{nameof(DateTime.Year), 一 10} = {dt.Year}\n" 
+ $"{nameof(DateTime.Month), ~ 10} = {dt.Month}\n" 
+ $"{nameof(DateTime.Day), 一 10} = {dt.Day}\n" 
+ $"{nameof(DateTime.Hour), —10} = {dt.Hour}\n" 
+ $"{nameof(DateTime.Minute), — 10} = {dt.Minute}\n" 
+ $"{nameof(DateTime.Second), ~- 10} = {dt.Second}"; 
Console. WriteLine(msg); 


步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-12 所 示 。 


图 5-12 从 字符 串 分 析出 来 的 日 期 与 时 间 


5.3 常用 的 字符 串 处 理 


实例 127 使 用 Concat 方法 拼接 字符 串 

【导语 】 

String 类 公开 了 一 个 名 为 Concat 的 静态 方法 ,该 方法 的 作用 是 将 多 个 字符 串 拼接 成 一 
个 新 的 字符 串 实 例 。Concat 方法 是 直接 拼接 字符 串 的 ,此 过 程 中 不 会 使 用 任何 分 隔 符 。 例 
如 ,字符 串 “he” 与 字符 串 “llo”, 调 用 Concat 方法 拼接 后 将 返回 “hello”。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 3 个 string 类 型 的 变量 并 初始 化 。 


string s1 = "abc"; 
string s2 = "def"; 
string s3 = "ghi"; 


步骤 3: 调用 Concat 方法 将 以 上 3 个 字符 串 实例 进行 拼接 。 


string sn = string.Concat(s1，s2，s3); 
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Console. WriteLine( sn); 


步骤 4: 运行 应 用 程序 项 目 ,Concat 方法 会 把 字符 串 直 接合 并 ,输出 的 新 字符 串 实 例如 下 。 


abcdefghi 
实例 128 ”使 用 “十 ”运算 符 拼接 字符 串 
【导语 】 


对 于 数值 ,“ 十 "运算 符 表现 为 加 法 运算 ,而 对 于 字符 串 实例 , 则 可 用 于 拼接 ,其 效果 与 
Concat 方法 相同 ,也 是 直接 将 多 个 字符 串 实例 连接 起 来 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 4 个 string 类 型 的 变量 ,并 进行 赋值 。 

string a = "今天 "; 

string b = "的 天 气 "; 


stringc = "很 "; 
string d = "晴朗 。"; 


步骤 3: 使 用 “十 ”运算 符 把 以 上 4 个 字符 串 实例 连接 起 来 。 
stringr =at+b+ctd; 


步骤 4: 运行 应 用 程序 项 目 ,拼接 后 的 字符 串 如 下 。 


今天 的 天 气 很 晴朗 。 
实例 129 ”字符 串 的 包含 关系 
【导语 】 


Contains 方法 用 于 检查 某 个 字符 串 中 是 否 包含 指定 的 子 字符 串 ,如 果 包 含 子 字符 串 , 则 
返回 true, 和 否则 返回 false。 

例如 ,字符 串 “ 百 川 东 到 海 * 中 如 果 包 含 子 字符 串 “ 百 川 ”, 那 么 Contains 方法 就 返回 true。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变量 ,并 进行 初始 化 , 稍 后 将 验证 在 该 字符 串 中 是 否 包 含 单词 


need 。 
string test = "I need peace with you"; 
步骤 3: 判断 以 上 字符 串 中 是 否 包含 单词 need。 
bool b = test.Contains("need"); 


步骤 4: 将 验证 结果 输出 到 屏幕 上 。 
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Console. WriteLine(" 句 子 {0} 中 {1} 单 词 need."，test, b ? "包含 " : "不 包含 "); 
步骤 5: 运行 应 用 程序 项 目 , 屏 幕 输出 的 内 容 如 下 。 


句子 I need peace with you 中 包含 单词 need。 


实例 130 ”字母 的 大 小 写 转换 

【导语 】 

将 字符 串 中 的 字母 全 部 转换 为 大 写字 母 ,可 以 调用 ToUpper 方法 ; 若 需 要 全 部 转换 为 
小 写字 母 ,应 调用 ToLower 方法 。 


注意 : 这 两 个 方法 对 中 文字 符 无 效 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 字符 串 变 量 ,并 为 其 赋值 。 


string test = "I will be very hard to do it"; 

步骤 3: 将 字符 串 中 的 所 有 字母 全 部 转换 为 大 写 ,并 输出 。 
Console. WriteLine( $ "全 部 转 为 大 写 :{test. ToUpper()}"); 

步骤 4: 将 字符 串 中 的 字母 全 部 转换 为 小 写 ,并 输出 。 
Console. WriteLine( $ "全 部 转 为 小 写 :{test. ToLower()}"); 


步骤 5: 按 下 F5 快捷 键 ,运行 应 用 程序 项 目 , 屏 幕 输出 内 容 如 图 5-13 所 示 。 


图 5-13 ”字母 的 大 小 写 转换 


实例 131 使 用 分 隔 符 连 接 字符 串 

【导语 】 

使 用 Concat 方法 或 者 “十 ”运算 符 是 将 字符 串 直 接连 接 的 ,未 添加 任何 分 隔 的 字符 ,但 
是 在 有 些 情 况 下 ,连接 字符 串 后 ,希望 每 个 子 串 之 间 都 有 一 个 分 隔 的 符号 。 例 如 ,将 十 六 进 
制 字符 串 ( 用 十 六 进 制 表示 字 节 ) 连 接 后 ,希望 每 字 节 之 间 都 用 一 个 -连接 。 假 设 有 3 个 字 
符 串 : 7E、9F、26 ,拼接 后 变 成 : 7E-9F-26 。 

要 实现 在 连接 字符 串 的 同时 使 用 分 隔 符 ,可 以 调用 String 类 的 Join 方法 ,尽管 这 个 方 
法 有 多 个 重 载 版 本 ,不 过 用 法 一 样 。 第 一 个 参数 用 于 指定 分 隔 符 ,第 二 个 参数 是 要 进行 连接 
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的 字符 串 列 表 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 数组 ,并 使 用 几 个 字符 串 对 象 初始 化 。 稍 后 会 将 这 些 字符 串 元 
素 拼 接 为 一 个 新 的 字符 串 实例 。 


string[] strs = { "abc"，"opq"，"uvw"，"xyz" }; 
步骤 3: 调用 Join 方法 将 上 面 字符 串 数 组 中 的 元 素 进行 拼接 ,分 隔 符 为 下 画 线 (_)。 
string outstr = string.Join('_', strs); 

步骤 4: 运行 应 用 程序 项 目 ,输出 的 新 字符 串 实例 如 下 。 


abc_opq_uvw_xyz 


实例 132 ”查找 以 “ay” 结 尾 的 单词 

【导语 】 

String 类 有 一 对 方法 ,可 用 于 分 析 字 符 串 的 开头 与 结尾 部 分 。StartsWith 方法 可 用 于 
判断 当前 字符 串 是 否 以 某 个 字符 或 字符 串 开头 ; 相应 地 ,EndsWith 方法 可 用 于 分 析 当 前 字 
符 串 是 否 以 某 个 字符 或 字符 串 结尾 。 

这 两 个 方法 都 是 返回 布尔 类 型 的 值 , 若 结果 为 真 表明 在 字符 串 的 开头 或 结尾 找到 了 需 
要 的 字符 ,否则 要 查找 的 字符 不 存在 。 例 如 ,用 StartWith 方法 在 字符 串 “then” 中 查找 
“th”, 方 法 调用 后 将 返回 true, 因 为 单词 then 确实 是 以 th 开头 。 

本 实例 将 从 一 个 字符 串 数组 中 查找 以 “ay” 结 尾 的 字符 串 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 数组 ,用 于 稍 后 做 测试 。 


string[ ] test = { "day"”, "toy", "try", "pay", "they", "may" }; 
步骤 3: 使 用 foreach 循环 ,从 以 上 数组 中 找 出 以 ay” 结尾 的 元 素 ,并 输出 到 屏幕 上 。 


foreach( string s in test) 


{ 
if (s. EndsWith("ay")) 
{ 
Console. WriteLine(s); 
} 
} 


在 当前 字符 串 中 查找 是 否 以 某 个 字符 或 字符 串 结尾 ,应 
调用 EndsWith 方法 。 
步骤 4: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-14 所 示 。 图 5 14 查找 以 “ay 结尾 的 学 
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实例 133 ”依据 指定 的 分 隔 符 来 拆 分 字符 串 


【导语 】 
Split 方法 的 作用 与 Join 方法 相反 。Join 方法 是 以 指定 的 分 隔 符 来 连接 字符 串 , 而 


Split 方法 则 是 依据 指定 的 分 隔 符 来 拆 分 字符 串 。 


例如 ,字符 串 “A 十 B 十 C” ,指定 分 隔 符 为 "十 ”, 于 是 将 拆 分 出 三 个 字符 串 实 例 一 一 A、B、 


C, 同 时 分 隔 符 “ 十 ”会 被 删除 , 即 返回 的 字符 中 是 不 包含 分 隔 符 的 。 因 为 拆 分 之 后 会 出 现 几 
段 字 符 串 实例 ,所 以 Split 方法 的 返回 类 型 为 string 数组 。 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 变量 ,并 初始 化 。 

string test = "enlarge* a* picture"; 

步骤 3: 以 上 述 字符 串 中 的 “* ”字符 为 分 隔 符 ,对 字符 串 进 行 拆 分 。 
string[ ] results = test.Split('#* '); 

步骤 4: 输出 拆 分 后 的 字符 串 。 


foreach (string s in results) 
{ 
Console. Write(" {0}", s); 


F 
步骤 5: 运行 应 用 程序 项 目 ,应 用 程序 输出 的 内 容 如 ”图 5-15 拆 分 后 的 字符 囊 


图 5-15 所 示 。 


和 


日 


实例 134 ”替换 字符 串 


【导语 】 
Replace 方法 分 两 步 完 成 工作 ,首先 从 原来 的 字符 串 实例 中 查找 到 要 被 替换 的 子 字符 


,然后 再 用 新 的 子 字符 串 蔡 换 掉 已 查找 到 的 子 字符 串 。 如 果 在 原 字 符 串 中 找 不 到 被 替换 


的 字符 串 ,那么 Replace 就 将 原 字 符 串 返回 。 


【操作 流程 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 string 类 型 的 变量 ,并 进行 初始 化 。 


string str = "明天 去 买 一 台 洗衣 机 "; 
步骤 3: 把 上 面 字 符 串 中 的 “洗衣 机 ” 芋 换 为 “ 电 冰 箱 ”。 
string res = str.Replace(" 洗 衣 机 "，" 电 冰箱 ") ; 
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步骤 4: 为 了 对 比 蔡 换 前 后 的 效果 ,分 别 将 原 字符 串 与 替换 后 的 字符 串 输出 到 控制 台 。 
Console. WriteLine( $ " 原 字符 串 :{str}\n 替换 后 的 字符 串 :{res}"); 
步骤 5: 运行 应 用 程序 项 目 ,得 到 如 图 5-16 所 示 的 结果 。 


图 5-16 替换 前 后 的 字符 串 对 比 


实例 135 有 反 转 字符 串 


【导语 】 

所 谓 反 转 字符 串 ,就 是 把 字符 串 中 所 有 字符 的 顺序 倒转 过 来 。 举 个 例子 ,假设 有 字符 串 
“编程 真 快乐 ”, 反 转 之 后 就 会 变 成 “ 乐 快 真 程 编 ”。 

char 类 型 表示 一 个 字符 ,而 字符 串 实际 上 是 由 多 个 单字 符 组 成 的 ,所 以 字符 串 实例 可 
以 先 提取 出 char 类 型 的 数组 对 象 , 然 后 再 调用 数组 对 象 的 Reverse 方法 将 里 面 的 char 元 素 
顺序 倒转 过 来 ,最 后 再 用 这 个 char 数组 重新 创建 字符 串 实例 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 ReverseString 方法 ,输入 参数 为 要 进行 反 转 的 字符 串 ,返回 内 容 为 已 
反 转 的 字符 串 。 

static string ReverseString(string input) 


{ 


char[ ] charr = input.ToCharArray(); 
Array. Reverse( charr); 
return new string(charr); 


注意 : Reverse 是 静态 方法 ,由 Array 类 公开 。 
String 与 string 指向 的 是 相同 的 类 型 。String( 首 字母 大 写 ) 是 .NET 中 的 类 型 , 即 
System. String 类 ,而 string( 小 写字 母 ) 是 语言 关键 字 , 实 际 上 也 指向 System. String 
类 。 因 此 ,在 代码 中 既 可 以 使 用 string, 也 可 以 使 用 String。 
类 似 的 情况 ,如 语言 关键 字 int, 实 际 上 指向 System. Int32 结构 ,在 代码 可 以 使 用 int 
关键 字 , 也 可 以 直接 用 Int32 结构 。 


步骤 3: 声明 一 个 string 类 型 的 变量 ,并 赋值 。 
string str = "一 行 白 览 上 青天 "; 
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步骤 4: 调用 前 面 定义 的 ReverseString 方法 ,将 字符 串 进 行 反 转 。 


string result = ReverseString(str); 


步骤 5: 为 了 能 直观 地 查看 效果 ,将 原 字符 串 与 反 
转 后 的 字符 串 都 输出 到 控制 台 。 

Console. WriteLine(" 原 字符 串 :{0}"，str); 

Console. WriteLine(" 反 转 后 的 字符 串 :{0}"，result); 

步骤 6: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-17 
所 示 。 


实例 136 ”插入 与 删除 字符 


【导语 】 

Insert 方法 可 以 在 原 字符 串 的 指定 位 置 插入 若干 字符 ,相对 应 地 ,Remove 方法 可 以 从 
原 字 符 串 中 删除 一 部 分 字符 。 

不 论 是 插入 字符 ,还 是 删除 字符 ,用 于 确定 操作 位 置 的 索引 都 是 基于 0 的 , 即 字符 串 的 
开头 位 置 为 0, 结尾 的 位 置 为 字符 串 长 度 减 去 1。 例 如 ,要 在 某 个 字符 串 的 第 3 个 字符 处 插 
入 内 容 , 那 么 其 位 置 索引 就 是 2。 

本 实例 先 演示 Insert 方法 的 使 用 ,后 演示 Remove 方法 的 使 用 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 变量 ,并 初始 化 。 


string test = "明天 吃饭 "; 


步骤 3: 在 上 面 字 符 串 的 “明天 ”后 面 插入 字符 串 “ 中 午 ”, 插 入 位 置 为 第 3 个 字符 处 , 索 
引 为 2。 


图 5-17 反 转 字符 串 


test = test. Insert(2, "中 午 "); 

插入 后 返回 新 的 字符 串 实例 ,此 时 字符 串 变 为 “明天 中 午 吃饭 ”。 

步骤 4: 在 “中 午 ” 后 面 插入 "出 去 ”, 插 入 位 置 为 第 5 个 字符 处 ,索引 为 4。 
test = test. Insert(4, "出 去 "); 

此 时 返回 的 新 字符 串 实例 为 “明天 中 午 出 去 吃饭 ”。 

步骤 5: 再 向 test 变量 赋值 一 个 新 的 字符 串 实例 。 

test = "小 桥 公 路 流水 人 家 "; 


步骤 6: 需要 将 上 述 字 符 串 中 的 “公路 "删除 ,可 调用 Remove 方法 ,开始 位 置 为 第 3 个 
字符 ,索引 为 2, 删 除 字符 数 为 2。 
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test = test.Remove(2, 2); 
执行 Remove 方法 后 ,将 返回 新 的 字符 串 实例 , 原 字 符 串 变 为 “小 桥 流水 人 家 ”。 
实例 137 填充 剩余 “空白 ” 


【导语 】 

String 类 公开 了 两 个 方法 ,支持 用 指定 的 字符 来 填充 原 字符 串 中 的 剩余 空间 。PadLeft 
方法 将 原 字 符 串 右 对 齐 , 并 在 左边 填充 ; 相反 地 ,PadRight 方法 则 将 原 字 符 串 左 对 齐 , 并 在 
右边 填充 。 这 两 个 方法 各 有 两 个 重 载 。 

String PadLeft(int totalWidth); 

String PadLeft( int totalWidth, char paddingChar); 

String PadRight( int totalWidth); 

String PadRight( int totalWidth, char paddingChar); 

totalWidth 指定 填充 后 新 字符 串 实例 的 长 度 , 如 果 原 字符 串 长 度 为 6, 而 totalWidth 参 
数 指定 为 10 ,那么 新 字符 串 中 会 包含 原 字符 串 和 4 个 填充 的 字符 。paddingChar 参数 表示 
用 来 填充 的 字符 ,如 果 不 指定 paddingChar 参数 , 则 默认 使 用 空格 来 填充 。 

【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 ,使 用 PadRight 方法 对 示例 字符 串 进行 右 侧 填充 。 


Console. WriteLine("abcd". PadRight(20, '* ')); 

Console. WriteLine("abcdef".PadRight(20, '* ')); 
Console. WriteLine("abcdefgh".PadRight(20, '* ')); 
Console. WriteLine("abcdefghijklmn". PadRight(20, '@')); 


步骤 3: 使 用 PadLeft 方 法 对 示例 字符 串 进行 左 侧 填 充 。 


Console. WriteLine("opq". PadLeft(16, '+ ')); 
Console. WriteLine("opqrst".PadLeft(16, '#")); 


步骤 4: 运行 应 用 程序 项 目 ,屏幕 输出 结果 如 图 5-18 所 示 。 图 5-18 填充 后 的 字符 串 

实例 138 ”判断 字符 是 否 为 数字 

【导语 】 

char 结构 有 两 个 方法 可 以 用 于 检测 某 个 字符 是 否 为 数字 。 

IsDigit 方法 仅 能 用 于 判断 标准 的 十 进 制 数字 字符 , 即 从 0 到 9, 共 10 个 字符 。 而 
IsNumber 方法 的 适用 面 更 广 , 不 仅 可 用 于 判断 标准 十 进 制 数字 字符 , 它 还 可 用 于 判断 其 他 
Unicode 数字 字符 ,例如 ,“@”“( 岂 ”iV”“1/2” 等 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


站 站 六 站 站 六 六 站 站 六 站 站 站 站 站 站 
于 让 太太 站 太太 站 站 六 站 计 太 六 
ef gh 冰冰 站 让 六 站 站 冰 六 站 


defghi jklmnegeoaea 
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步骤 2: 声明 一 个 char 类 型 数组 ,用 于 初始 化 的 字符 串 ,其 中 混 有 数字 字符 与 非 数字 字 
符 , 用 于 稍 后 进行 判断 处 理 。 


Sa] chare = OE, MD BR 
步骤 3: 调用 IsNumber 方法 对 数组 中 的 字符 进行 判断 。 


foreach(char c in charr) 
{ 


A 


Console. WriteLine("{0} {1} 数 字 ", c, char. IsNumber(c) ? 
"是 " : "不 是 "); 
} 


步骤 4: 运行 应 用 程序 项 目 , 输 出 结果 如 图 5-19 所 示 。 
图 5-19 判断 是 否 为 数字 字符 
实例 139 ”截取 字符 串 


【导语 】 

截取 字符 串 ,就 是 从 原 字符 串 实例 中 取出 部 分 内 容 , 并 产生 新 的 字符 串 实例 。 例 如 , 字 
符 串 “abcdefghijklmn”, 假 设 从 第 3 个 字符 开始 ,截取 4 个 字符 ,那么 得 到 的 新 字符 串 ( 或 称 
为 子 串 ) 就 是 “cdef”。 

截取 字符 串 的 功能 由 Substring 方法 实现 , 它 有 两 个 重 载 版 本 。 


String Substring(int startIndex); 
String Substring(int startIndex, int length); 


如 果 不 指定 length 参数 (要 截取 字符 的 个 数 ), 则 从 startIndex 参数 所 指定 的 位 置 开 始 ， 
- 直 截 取 到 字符 串 的 末尾 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 做 测试 的 string 类 型 变量 ,并 赋 初 始 值 。 

string s = "从 此 地 出 发 ,大 约 需 要 二 十 分 钟 "; 

步骤 3: 从 第 7 个 字符 开始 ,截取 7 个 字符 。 

string sub = s.Substring(6, 7); 

startIndex 参数 所 指定 的 位 置 索引 是 从 0 开始 计算 的 ,第 7 个 字符 的 位 置 应 为 6。 

步骤 4: 同时 输出 截取 前 后 的 字符 串 实例 ,以 方便 对 比 。 

Console. WriteLine("{0} -> {1}", s, sub); 

步骤 5: 运行 应 用 程序 项 目 ,输出 内 容 如 下 。 

从 此 地 出 发 , 大约 需要 二 十 分 钟 -> 大 约 需 要 二 十 分 
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实例 140 ”使 用 StringBuilder 组 装 字符 串 


【导语 】 

StringBuilder 类 为 字符 串 的 组 装 提供 了 比较 综合 的 功能 ,覆盖 了 字符 串 的 各 种 操作 。 
主要 有 : 

(1) 追加 。 扎 加 就 是 在 现 有 字符 串 的 末尾 拼接 内 容 。 有 四 个 与 追加 操作 相关 的 方法 ， 
Append 方法 是 直接 把 内 容 追 加 到 字符 串 末尾 ,不 带 换行 符 ; AppendLine 方法 追加 字符 串 
后 会 自动 在 末尾 加 上 换行 符 (\n); AppendFormat 方法 在 追加 字符 串 时 支持 使 用 格式 化 字 
符 串 ; AppendJoin 方法 与 string. Join 方法 相似 , 先 将 各 个 部 件 通过 分 隔 符 串 联 起 来 ,再 追 
加 到 原 字符 串 末 尾 。 

(2) 插入 与 删除 。Insert 方法 可 以 在 原 字 符 串 的 某 个 位 置 插入 新 内 容 , 它 与 追加 不 同 ， 
追加 只 能 把 新 内 容 拼接 到 原 字 符 串 的 末尾 ,而 Insert 方法 则 可 以 在 任意 有 效 位 置 写 人 新 内 
容 。 要 从 指定 位 置 删除 若干 字符 ,可 以 使 用 Remove 方法 。 

(3) 替换 。 调 用 Replace 方 法 ,可 以 将 原 字 符 串 的 指定 内 容 蔡 换 为 新 的 内 容 。 

(4) 清除 。 调 用 Clear 方法 将 删除 StringBuilder 实例 已 缓存 的 所 有 字符 。 

当 字 符 串 组 装 完成 ,可 调用 StringBuilder 实例 的 ToString 方法 返回 已 组 装 好 的 字符 串 
实例 (CString 类 型 ) 。 

有 意思 的 是 ,StringBuilder 类 有 很 多 方法 的 返回 类 型 也 是 StringBuilder, 也 就 是 说 , 当 
调用 某 个 方法 完成 某 项 处 理 后 ,StringBuilder 对 象 会 把 自身 返回 给 调用 方 。 这 种 设计 模型 
的 好 处 是 可 以 连续 调用 一 个 对 象 实例 的 多 个 方法 。 例 如 以 下 形式 。 


builder. AppendLine(*…) 
.Append(*…) 
. Append(*…) 
Append( … ); 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 引入 System. Text 命名 空间 。 


using System. Text; 

步骤 3: 实例 化 StringBuilder 对 象 。 
StringBuilder builder = new StringBuilder(); 
步骤 4: 向 builder 变量 中 添加 内 容 。 


builder. AppendLine( "Happy !") 
. Append( "abc") 
.Append("—") 
. Append( "xyz\n") 
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.AppendFormat ("0x{0:x} = {0}\n", 144650) 
. AppendJoin('~', 50, false, 3.6625d) 
. AppendLine() 
.Replace( "Happy", "Hello Jim"); 
以 上 代码 对 builder 变量 采取 实例 方法 的 连续 调用 ,分 别 进行 了 以 下 处 理 : 
(1) 添加 一 行 *“Happy !”。 
(2) 添加 字符 串 “abe”, 无 换行 符 。 
(3) 添加 字符 “-”, 无 换行 符 。 
(4) 添加 字符 串 “xyz”, 后 跟 换 行 符 “\n”。 
(5) 通过 格式 化 标志 添加 整数 值 144650,“ 二 "左边 是 十 六 进 制 表 示 方 式 ( 使 用 x 格式 标 
志 , 表 示 十 六 进 制 ),“==” 右 边 是 整数 的 默认 表示 方式 (十 进 制 ) 。 
(6) 用 字符 “一 ”将 整数 值 50、 布 尔 值 false、 双 精度 小 数 3. 6625 连接 起 来 ,再 追加 到 
StringBuilder 实例 中 。 
(7) 追加 一 个 空白 行 (调用 无 参数 的 AppendLine 方法 ) 。 
(8) 将 前 面 添 加 的 “Happy” 字 符 串 替换 为 *Hello Jim”。 
步骤 $: 调用 Console. WriteLine 方法 将 StringBuilder 中 
的 内 容 输出 到 屏幕 。 


Console. WriteLine(builder); 


WriteLine 方法 会 自动 调用 builder 变量 的 ToString 方法 。 


步骤 6: 运行 应 用 程序 项 目 ,屏幕 输出 如 图 5-20 所 示 。 人 

实例 141 ”字符 串 查 找 SN 

【导语 】 

字符 串 查 找 的 结果 是 返回 被 找到 字符 串 所 在 的 位 置 , 如 果 没 有 找到 要 查找 的 字符 串 , 那 
么 就 返回 一 1。 


IndexOf 方法 与 LastIndex0Of 方法 的 作用 正好 是 相对 的 。 如 果 要 查找 的 字符 串 在 原 字 
符 串 中 出 现 多 次 ,那么 IndexOf 方法 返回 字符 串 第 一 次 出 现时 的 位 置 ,而 LastJndexOf 方法 
则 是 返回 字符 串 最 后 一 次 出 现时 的 位 置 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 变量 ,并 进行 初始 赋值 。 


string test = "明日 复明 日 ,明日 何其 多 "; 


步骤 3: 上 述 字符 串 变量 中 ,出 现 了 三 个 “上 明日”, 下面 代码 分 别 找 出 “明日 "第 一 次 和 最 
后 一 次 出 现 的 位 置 。 


int first = test. IndexOf(" 明 日 "); 
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int last = test.LastIndexOf(" 明 日 "); 
步骤 4: 在 控制 台中 输出 相关 信息 。 


Console. WriteLine("" 明 日 "在 "{0}" 中 第 一 次 出 现 的 位 置 是 :{1}， 
最 后 一 次 出 现 的 位 置 是 :{2}。",， test, first, last); 


步骤 5: 运行 应 用 程序 项 目 , 输 出 结果 如 图 5-21 所 示 。 图 5-21 查找 字符 串 的 位 置 
实例 142 ”比较 字符 串 时 忽略 大 小 写 

【导语 】 

String 类 的 Compare 方法 有 以 下 重 载 版 本 。 


static int Compare( String strA, String strB, bool ignoreCase); 


方法 对 两 个 字符 串 对 象 (strA 与 strB) 进 行 比 较 , 如 果 两 者 相同 ,Compare 方法 返回 0; 
如 果 返 回 非 0 值 ,表示 两 个 字符 串 对 象 并 不 相同 。 当 返回 值 大 于 0 时 ,表示 strA 在 字符 排 
序 上 要 比 strB 更 靠 后 ,反之 则 更 靠 前 。 例 如 ,strA 为 “abc”,strB 为 “xyz”, 那 么 , 相 比 较 后 ， 
返回 值 为 一 1, 因 为 “abc" 在 字符 中 的 排序 更 靠 前 。 

字符 排序 一 般 有 这 几 种 依据 : 数字 顺序 .字母 顺序 .中文 拼音 顺序 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 string 类 型 的 变量 ,并 进行 初始 化 。 


string sl "abcd"; 


"ABCD"; 


string s2 
步骤 3: 对 上 面 两 个 字符 串 进行 比较 。 
int rc = string.Compare(sl, s2, true); 


步骤 4: 输出 比较 结果 。 这 = 


Console. Write( $ "忽略 大 小 写 差 异 后 ,{sl} 与 {s2} "); 
if (rc == 0) v 


Console. Write(" 相 等 ") ; 
图 5-22 忽略 大 小 写 后 


Console. Write(" 不 相等 ") ; 两 字符 串 相等 
步骤 5: 运行 应 用 程序 项 目 , 输 出 结果 如 图 5-22 所 示 。 
实例 143 “@” 符 号 在 字符 串 中 的 用 途 
【导语 】 


在 字符 串 常量 前 面 加 上 一 个 “@” 符 号 ,表示 将 忽略 字符 串 中 的 转 义 字符 ,如 “\n”“\t” 
“\r” 等 ,尤其 是 在 输入 文件 路 径 的 时 候 该 符号 特别 有 用 。 
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例如 ,在 不 使 用 *@” 符 号 时 ,文件 路 径 需 要 这 样 处 理 : 
"\\folderl\\folder2\\test. pptx" 

于 “\" 是 转 义 字符 的 开始 标志 ,因此 如 果 在 文本 中 出 现 该 字符 ,就 必须 写成 “\”。 而 在 使 
用 了 “@” 符 号 之 后 , 转 义 字符 被 忽略 ,就 可 以 直接 使 用 原 义 字 符 。 

@"\folderl\folder2\test. pptx" 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 变量 ,并 为 其 赋值 。 

string s = @" 文 本 一 \n 文 本 二 \t 文 本 三 "; 

步骤 3: 将 字符 串 输 出 到 屏幕 。 

Console. WriteLine( s); 

步骤 4: 运行 应 用 程序 项 目 ,控制 台 窗 口 将 输出 以 下 内 容 。 

文本 一 \n 文 本 二 \t 文 本 三 
因为 "@" 符 号 忽略 了 所 有 的 转 义 字符 ,所 以 ,“\n” 和 “\t" 不 会 被 视 为 换行 符 和 制 表 符 ， 
而 仅仅 作为 普通 字符 输出 。 

实例 144 ”处 理 字符 串 中 出 现 的 双 引 号 

【导语 】 

由 于 字符 串 常量 本 身 需 要 放 在 一 对 双 引 号 中 ,因此 ,如 果 字 符 串 中 出 现 双 引 号 , 那 就 得 
进行 特殊 处 理 。 

如 果 字 符 串 常量 没有 使 用 “@” 符 号 ,可 以 通过 转 义 的 方式 解析 字符 串 中 的 双 引 号 ,形式 
如 下 : 

"the output content is \"data updated\"" 

如 果 字 符 串 常 量 使 用 了 “@”, 此 时 转 义 失效 ,需要 在 字符 串 中 出 现 的 双 引 号 可 以 用 连续 
两 个 双 引 号 表示 。 

@"run ""cmd""" 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 string 类 型 变量 并 赋值 ,在 字符 串 常量 中 使 用 转 义 字符 插入 双 引 号 ,随后 
将 其 输出 。 


string sl = "type in \"dir\""; 
Console. WriteLine(s1); 
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步骤 3: 在 带 “@” 符 号 的 字符 串 中 ,通过 连续 输入 两 个 双 引 号 的 方式 插入 双 引 号 。 并 将 
字符 串 输出 。 


string s2 = @"execute the ""dotnet new"" command" 
Console. WriteLine(s2); 


步骤 4: 运行 应 用 程序 项 目 后 ,控制 台 窗口 输出 以 下 文本 。 
type in "dir" 


execute the "dotnet new" command 


注意 ; 如 果 字 符 串 中 包含 中 文 的 双 引 号 ,不 需 做 任何 处 理 。 因 为 中 文 的 标点 符号 不 会 干 拓 
代码 编译 。 


5.4 格式 控制 符 


实例 145 ”输出 百分比 


【导语 】 

百分比 的 格式 控制 符 为 *P? 或 “p”, 使 用 该 格式 控制 符 , 可 以 将 普通 数值 输出 为 百分比 
形式 ,也 就 是 将 原 数 值 乘 以 100 并 在 后 面 接 上 “%” 符 号 。 

在 格式 控制 符 后 面 紧 跟 一 个 整数 ,可 以 指定 要 保留 的 小 数位 数 。 例 如 ,“P3” 表 示 将 原 
数值 输出 为 百分比 形式 ,并 保留 3 位 小 数 。 

举 个 例子 , 浮 点 数 0.003, 使 用 “P” 格 式 控 制 符 后 ,输出 的 字符 串 为 “0. 30%”。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 并 初始 化 一 个 单 精度 浮 点 数值 。 


float val = 0.1785f; 


步骤 3: 使 用 “P” 格 式 控 制 符 输 出 以 上 数值 的 百分比 形式 ,默认 情况 下 ,“P” 格 式 控制 符 
将 保留 2 位 小 数 。 

Console. WriteLine( $ "{"p", ~ 15} {val, ~ 10:p}"); 

步骤 4: 使 用 “P3” 格 式 控制 符 输出 百分比 形式 ,而 且 保 
留 3 位 小 数 。 

Console. WriteLine( $ "{"p3", ~ 15}{val, ~ 10:p3}"); 

步骤 5: 按 下 F5 快捷 键 运行 应 用 程序 项 目 ,控制 台 的 
003 图 5-23 输出 百分比 格式 文本 
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实例 146 ”输出 当前 语言 中 的 货币 格式 

【导语 】 

使 用 “C” 或 “c” 格 式 控制 符 所 输出 的 文本 ,会 在 文本 前 面 加 上 一 个 货币 符号 。 该 格式 控 
制 符 是 根据 当前 系统 所 使 用 的 区 域 与 语言 属性 来 确定 货币 符号 的 ,例如 人 民 币 将 使 用 “站 ” 
符号 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 直接 使 用 “ce” 格 式 控制 符 输出 数值 ,默认 保留 2 位 小 数 。 

WriteLine("{0:c}", 20.5); 

输出 结果 如 下 。 

¥20.50 

步骤 3: 输出 货币 格式 ,并 保留 1 位 小 数 。 

WriteLine("{0:c1}", 150.39); 


输出 结果 将 小 数 部 分 的 0. 39 四 舍 五 人 , 变 为 如 下 形式 。 


¥150.4 
步骤 4: 输出 货币 格式 , 仅 保留 整数 部 分 。 
WriteLine("{0:c0}", 83.71); 

输出 时 将 去 掉 小 数 部 分 ,结果 如 下 。 


¥84 


实例 147 输出 多 个 币 种 格式 


【导语 】 
许多 数值 类 型 (如 double、decimal 等 ) 都 公开 一 个 特殊 的 ToString 方法 重 载 。 


string ToString( string format, IFormatProvider provider); 


format 参数 指定 格式 控制 符 ,provider 是 一 个 接口 ,其 中 一 个 实现 类 是 位 于 System. 
Globalization 命名 空间 下 的 CultureInfo。CulturelInfo 类 封装 了 与 各 地 区 的 语言 与 文化 信 
息 相 关 的 数据 。 

获取 CultureInfo 实例 有 多 种 方法 ,例如 可 以 通过 调用 构造 函数 进行 实例 化 ,并 向 构造 函数 传 
递 区 域 /语言 名 称 或 标识 ID; 还 可 以 通过 GetCultureInfo .GetCultureInfoByIetfLanguageTag 等 静 
态 方法 来 直接 获得 CultureInfo 实例 。 
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除了 ToString 方法 ,还 可 以 使 用 String 类 的 Format 方法 、StringBuilder 类 的 
AppendFormat 方法 来 输出 由 IFormatProvider 修饰 的 格式 化 字符 串 。 

本 实例 将 演示 ToString 方法 结合 CulturelInfo 来 输出 不 同 货币 的 文本 表示 形式 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 变量 并 赋 一 个 十 进 制 数值 ,用 于 稍 后 做 测试 。 


decimal val = 3960.12M; 


步骤 3: 获取 6 个 CultureInfo 实例 ,分别 表示 时 
国 澳门 .日 本 。 


TD 
十 


国 大 陆 、. 中 国 台湾 美国. 中国 香 港 . 


CultureInfo cn = CultureInfo. GetCultureInfoByIetfLanguageTag("zh 一 CN" ); 
CultureInfo tw = CultureInfo.GetCultureInfoByIetfLanguageTag("zh— TW"); 
CultureInfo us = CultureInfo.GetCultureInfoByIetfLanguageTag("en— US"); 
CultureInfo mo = CultureInfo.GetCultureInfoByIetfLanguageTag("zh— MO"); 
CultureInfo hk = CultureInfo.GetCultureInfoByIetfLanguageTag("zh— HK"); 
CultureInfo jp = CultureInfo.GetCultureInfoByIetfLanguageTag("ja— JP"); 


步骤 4: 根据 上 面 获取 的 6 个 区 域 信息 ,输出 不 同 的 货币 
格式 。 

Console. WriteLine(" 原 数值 : {0}\n", val); 

Console. WriteLine(" 人 民 币 :{0}", val. ToString("C", cn)); 

Console. WriteLine(" 台 币 :{0}", val. ToString("C", tw)); 

Console. WriteLine(" 美 元:{0}"， val. ToString("C", us)); 

Console. WriteLine(" 澳 元 :{0}"， val. ToString("C", mo)); 

Console. WriteLine(" 港 币 :{0}"，val.ToString("C"，hk) ); 

Console. WriteLine(" 日 元 :{0}", val.ToString("C", jp)); 


步骤 5: 运行 应 用 程序 项 目 ,屏幕 输出 内 容 如 图 5-24 所 示 。 图 524 输出 多 种 货币 格式 
实例 148 ”数字 的 两 种 常用 格式 


【导语 】 

数字 一 般 有 两 种 表示 格式 : 一 种 是 直接 表示 (格式 控制 符 为 G) ,例如 12345678. 6665， 
还 有 一 种 也 比较 常见 , 即 每 隔 3 位 就 用 一 个 英文 的 逗号 标注 (格式 控制 符 为 N), 例 如 
12,345,678. 22。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 decimal 变量 并 赋值 。 


decimal d = 8582113.76352M; 


“M” 是 一 个 类 型 后 级 ,在 数值 后 面 加 上 “M” 或 “*m”, 表 示 一 个 decimal 类 型 的 数值 ,就 像 
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可 以 在 双 精 度数 值 后 面 加 上 *“d” 一 样 。 
步骤 3: 分 别 以 “"G” 和 “N” 格 式 输出 数值 的 字符 串 形式 。 


Console. WriteLine("{0, -15}{1, ~ 20:6G}", "G",d); 

Console. WriteLine("{0, -15}{1, — 20:N}", "N", d); 

在 Console. WriteLine 方法 或 者 String. Format 方法 中 ,格式 占 位 符 用 一 对 大 括号 括 着 
的 整数 值 表示 ,从 0 开始 计算 。 在 格式 占 位 符 中 ,以 逗号 
(英文 ) 开 头 表示 被 格式 化 文本 的 对 齐 方式 , 正 数值 表示 
右 对 齐 , 负 数值 表示 左 对 齐 , 数 字 表示 所 占用 的 字符 数 ， 
如 果 格 式 化 输出 的 内 容 小 于 该 长 度 , 则 用 空格 填充 剩余 
空间 。 以 冒号 (英文 ) 开 头 表 示 要 使 用 的 格式 控制 符 , 例 
如 本 例 中 用 到 的 %“G” 和 “N”。 

步骤 4: 按 下 快捷 键 F5 运行 应 用 程序 项 目 , 输 出 结 
果 如 图 5-25 所 示 。 


实例 149 ”使 用 字符 串 内 插 

【导语 】 

在 早期 的 版 本 中 ,要 对 字符 串 进行 格式 化 输出 ,一 般 需 要 借助 String 类 的 Format 方 
法 ,或 者 Console、TextWriter、StringBuilder 等 类 所 公开 的 相关 方法 。 但 是 这 些 方法 都 需要 
安排 从 0 开始 计算 的 格式 占 位 符 ,操作 起 来 也 不 太 简 便 。 

而 使 用 字符 串 内 插 ,就 可 以 直接 在 初始 化 字符 串 实例 时 插入 格式 控制 。 而 且 字符 内 插 
并 不 需要 基于 0 的 有 序 格式 占 位 符 , 在 一 对 大 括号 内 直接 写 上 表达 式 即 可 。 

例如 ,要 输出 字符 串 “ 圆 周 率 王 XXX”, 其 中 ,XXX 是 通过 Math. PI 常量 返回 的 。 此 时 
可 以 用 内 插 字符 串 。 


stringv = $ "圆周 率 = {Math.PI}"; 


在 运行 阶段 ,生成 的 字符 串 如 下 。 


国 CN\program Files.， 一 
数 人 3582113. 76352 


构 


图 5-25 输出 常见 的 数字 格式 


圆周 率 = 3.14159265358979 

字符 串 内 插 的 标志 是 字符 串 常量 前 要 加 上 “$ ”符号 ,否则 编译 器 仅 将 其 视 为 普通 字符 
串 ,内 插 的 表达 式 不 会 被 计算 。 

字符 串 内 搬 还 可 以 对 格式 设置 进行 补充 。 在 表达 式 之 后 ,用 
的 对 齐 方式 , 负 值 表示 左 对 齐 , 正 值 表示 右 对 齐 ; 随后 以 冒号 ( 半 


逗号 (半角 ) 开 头 表示 字符 
角 


) 开 头 表示 格式 控制 符 。 
完整 的 格式 如 下 。 
{< 表达 式 >, < 对 齐 方 式 >:< 格 式 控制 符 >} 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


图 5-26 所 示 )， 
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步骤 2: 声明 两 个 int 类 型 的 变量 并 初始 化 。 

intm = 100; 

intn = 450; 

步骤 3: 使 用 字符 串 内 插 , 输 出 形 如 “A 十 B = C” 的 字符 串 。 


Console. WriteLine( $ "{m} + {n} = 
步骤 4: 声明 
double r = 7.325d; 


步骤 : 符 串 内 捅 ， 


{m + n}"); 


-个 double 类 型 的 变量 r, 它 表示 


-个 圆 的 半径 。 


5: 通过 字 输出 圆 的 面积 ,并 且 保 留 2 位 小 数 。 


Console. WriteLine( $ "半径 为 {r} 


在 表达 
步骤 6: 


100 + 450 = 550 
半径 为 7.325 的 圆 的 面积 为 :168. 56 


长 日 期 与 短 日 期 


的 圆 的 面积 为 :{ 


N2”, 表 示 输 出 的 值 为 常规 数字 ,“ 
项 目 , 输 出 结果 如 下 


Math.PI * r * r:N2}"); 
式 之 后 紧 跟 *: 2 表示 保留 


运行 应 用 程序 


实例 150 
【导语 】 


标准 日 期 格式 用 得 比较 多 的 是 长 日 期 和 短 日 期 ,具体 的 显示 方式 取决 于 系 


命 更 改 日 期 和 时 间 格 式 


一 周 的 第 一 天 
[ 


长 日 期 格式 
yy 年 M 月 dd 日 
短 时 间 格式 

H:mm v 
长 时 间 格式 


H:mm:ss 


图 5-26 ”Windows 系统 中 关于 日 期 格式 的 设置 


2 位 小 数 。 


统 的 设置 (如 
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调用 DateTime 实例 的 ToLongDateString 方法 可 以 直接 返回 长 日 期 字符 串 ,同样 , 调 
用 ToShortDateString 方法 可 以 返回 短 日 期 字符 串 。 不 过 本 实例 主要 演示 通过 格式 控制 符 
来 返回 长 日 期 和 短 日 期 字符 串 。 

长 日 期 的 格式 控制 符 为 *“D”, 短 日 期 的 格式 控制 符 则 为 “d”。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 。 

步骤 2: 初始 化 一 个 DateTime 对 象 , 稍 后 用 于 测试 。 


DateTime dt = new DateTime(2018, 5, 1); 
步骤 3: 使 用 *D” 和 *d” 格 式 控制 符 分 别 输出 上 述 日 期 的 长 日 期 和 短 日 期 形式 。 


Console. WriteLine( $ "长 日 期 :{dt:D}"); 
Console. WriteLine( $" 短 日 期 :{dt:d}"); 


步骤 4: 运行 应 用 程序 项 目 ,控制 台 输 出 内 容 如 下 。 


长 日 期 :2018 年 5 月 1 日 
短 日 期 :2018-5-1 


实例 151 ” 自 定义 日 斯 和 时 间 格 式 


【导语 】 

对 于 日 期 和 时 间 值 ,最 常用 到 的 有 年 、 月 \ 日 、 时 ,分 、 秒 ,其 中 每 一 部 分 都 有 对 应 的 格式 
控制 符 。 

(1) 年 。 一 般 使 用 “yyyy” 表 示 , 即 4 位 整数 ,如 2015。 也 可 以 使 用 控制 符 “yy”, 使 用 2 
位 整数 表示 ,如 2018 年 ,输出 为 18。 

(2) 月 。“M” 表 示 从 1 到 12,“MM” 表 示 从 01 到 12。 

(3) 日 。“d” 表 示 从 1 到 31,“dd” 表 示 从 01 到 31。 

(4) 时 。“h” 表 示 从 1 到 12,“hh” 表 示 从 00 到 12。 如 果 需 要 24 小 时 表示 方式 ,就 要 用 
大 写 的 HH, 即 “H” 表 示 从 0 到 23,“HH” 表 示 00 到 23。 

(5) 分 。“m” 表 示 从 0 到 59,“mm” 表 示 从 00 到 59。 

(6) 秒 。“s” 表 示 从 0 到 59,“ss” 表 示 从 00 到 59。 

例如 ,要 输出 形 如 “2017-6-3” 的 格式 ,格式 控制 符 为 *yyyy-M-d”; 要 输出 “2017-6-3 15: 
10: 20”, 则 格式 控制 符 为 *yyyy-M-d HH: mm: ss”。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 DateTime 类 型 的 变量 ,并 进行 初始 化 。 


DateTime dt = new DateTime(2018, 2, 1, 16, 37, 11); 
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步骤 3: 使 用 自 定义 的 格式 控制 符 ,调用 ToString 方法 返回 自 定义 的 日 期 /时 间 表 示 方 式 。 
Console. WriteLine( $" 自 定义 日 期 /时 间 格 式 :{dt. ToString("yyyy 一 M-d,HH:mm:ss")}"); 

步骤 4: 运行 应 用 程序 项 目 ,控制 台 输 出 内 容 如 下 。 

自 定义 日 期 /时 间 格 式 :2018 一 2 一 1,16:37:11 


实例 152” 自 定义 小 数位 数 


【导语 】 
“# ”与 “0” 格 式 控制 符 的 作用 相同 ,都 是 用 来 自 定义 数字 格式 的 。 但 是 两 个 格式 控制 符 
之 间 略 有 不 同 。 


“ 井 ” 仅 填充 有 效 位 ,如 果 某 数位 上 是 0 并 且 不 是 必需 的 ,那么 就 会 被 忽略 。 例 如 0. 2， 
使 用 *#. # # ?格式 控制 符 后 就 会 输出 “. 2” ,整数 部 分 的 0 会 被 忽略 ,小 数 部 分 虽然 有 2 位 ， 
但 只 有 “2” 才 是 有 效 位 。 

同样 以 0. 2 为 例 , 对 于 “0” 格 式 控制 符 ,“0.00” 就 会 输出 0. 20”"。 因 为 “0” 格 式 控制 符 对 
于 非 有 效 位 都 用 “0” 来 填充 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 double 类 型 的 变量 并 进行 赋值 。 


double d = 572.562170932d; 
步骤 3: 将 上 面 变量 的 值 转 为 字符 串 输出 ,分别 保留 5 位 小 数 、3 位 小 数 、1 位 小 数 ,以 及 
仅 保 留 整数 位 。 


Console. WriteLine(" 保 留 5 位 小 数 :{0}"，d. ToString("0.00000")); 
Console. WriteLine(" 保 留 3 位 小 数 :{0}"，,d. ToString("0.000")); 
Console. WriteLine(" 保 留 1 位 小 数 :{0}"，d. ToString("0.0")); 
Console. WriteLine(" 保 留 整数 :{0}",d. ToString("#")); 


步骤 4: 运行 应 用 程序 项 目 ,控制 台 输出 内 容 如 图 5-27 所 示 。 


5-27 保留 小 数位 
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5.5 从 字符 串 到 其 他 类 型 的 转换 


实例 153 ”从 二 进 制 字符 串 产生 int 实例 


【导语 】 

Convert 类 公开 了 一 组 方法 ,支持 将 整数 字符 串 转 换 为 整数 类 型 ,这 些 方法 包括 : 
byte ToByte( string value, int fromBase); 

short ToInt16(string value, int fromBase); 

static int ToInt32(string value, int fromBase); 

long ToInt64( string value, int fromBase); 

sbyte ToSByte( string value, int fromBase); 

ushort ToUInt16( string value, int fromBase); 

uint ToUInt32(string value, int fromBase); 

ulong ToUInt64( string value, int fromBase); 


这 些 方法 都 有 一 个 共同 的 参数 一 一 fromBase。 此 参数 用 于 指定 value 参数 属于 什么 进 
制 的 字符 串 。 如 果 字 符 串 表示 的 是 十 六 进 制 的 数值 ,那么 fromBase 参数 的 值 为 16。 

本 实例 演示 的 是 将 二 进 制 字符 串 转换 为 32 位 整数 值 。 其 他 整数 类 型 只 需要 调用 相对 
应 的 方法 即 可 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变 量 ,并 赋值 一 个 二 进 制 数值 。 


string str = "1011101001"; 


步骤 3: 调用 Convert. ToInt32 方法 将 二 进 制 字符 串 转 换 为 int 值 。 


int result = Convert.ToInt32(str, 2); 

步骤 4: 在 控制 台中 分 别 输出 转换 前 后 的 内 容 。 
Console. WriteLine( $"\"{str}\" —> {result}"); 

步骤 5: 运行 应 用 程序 项 目 ,控制 台 输出 内 容 如 下 。 


"1011101001" ->745 


实例 154 ”Parse 与 TryParse 方法 


【导语 】 
许多 基础 的 值 类 型 都 公开 了 两 个 方法 一 一 Parse 和 TryParse。 这 两 个 方法 的 作用 相 
同 , 即 对 传 入 的 字符 串 进行 分 析 , 然 后 产生 新 的 值 类 型 实例 。 假 设 调用 Double 结构 的 Parse 
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方法 ,如 果 能 够 顺利 分 析 传 递 给 方法 的 字符 串 ,就 会 返回 一 个 新 的 Double 实例 。Parse 方 
法 一 旦 分 析 失 败 就 会 抛 出 异常 。 而 TryParse 方法 在 字符 串 分 析 失 败 后 不 会 抛 出 异常 ,如 果 
分 析 成 功 , 该 方法 返回 true, 和 否则 返回 false。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变 量 , 将 其 通过 Parse 方法 进行 分 析 , 并 转换 为 double 类 型 
的 值 。 


string sl = "4.00012"; 
double vl = double.Parse(s1); 
Console. WriteLine("\"{0}\" -> {1}", sl, v1); 


步骤 3: 下 面 代码 使 用 Parse 方法 对 字符 串 进行 分 析 , 然 后 转换 为 DateTime 实例 。 


string s2 = "2016-11- 25"; 
DateTime v2 = DateTime,. Parse(s2); 
Console. WriteLine("\"{0}\" -> {1}", s2, v2); 


步骤 4: 接 下 来 通过 TryParse 方法 尝试 将 字符 串 转换 为 16 位 整数 值 。 


string s3 = "6507"; 
bool b = short. TryParse(s3, out short v3); 
if (b) 
{ 
Console. WriteLine("\"{0}\" -> {1}", s3, v3); 
} 
else 
{ 
Console. WriteLine(" 字 符 串 \"{0 八 "无 法 转换 为 16 位 整数 。"，s3); 
} 


步骤 $: 同样 ,使 用 TryParse 方 法 将 字符 串 转换 为 int 实例 。 


string s4 = "69kh" 
b = int.TryParse(s4, out int v4); 
if (b) 
{ 
Console. WriteLine("\"{0}\" -> {1}", s4, v4); 
} 
else 
{ 
Console. WriteLine(" 字 符 串 \"{0}\" 无 法 转换 为 32 位 整数 。"，s4); 
} 


由 于 变量 s4 中 包含 字母 “k” 和 “h”, 是 无 法 转换 成 整数 值 的 ,所 以 TryParse 方法 会 返回 false。 
步骤 6: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-28 所 示 。 
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C:\Program Files\dotnet\ — 口 


图 5-28 ”字符 串 分 析 结果 


实例 155 ”对 字符 串 进行 UTF-8 编码 


【导语 】 

在 一 些 特定 情况 下 ,例如 要 将 字符 串 写 人 到 文件 中 ,或 者 要 将 字符 串通 过 网 络 发 送 ,就 
要 考虑 对 字符 串 编码 的 问题 。 因 为 计算 机 是 以 字 节 方式 存储 数据 的 ,字符 串 在 存储 前 就 需 
要 转换 为 字 节 序列 ,这 便 是 编码 的 过 程 。 

常用 的 编码 格式 有 ASCII、UTF-8、GBK、GB2312 等 。 对 于 简体 中 文字 符 , 可 以 使 用 
GB2312 编码 ,但 为 了 提高 通用 性 ,一 般 使 用 UTF-8 编码 比较 多 。 

在 System. Text 命名 空间 下 的 Encoding 类 可 以 完成 字符 串 与 字 节 序列 之 间 的 转换 。 
为 了 方便 开发 者 调用 ,Encoding 类 还 以 静态 属性 的 形式 公开 常用 编码 的 实例 。 具 体 可 参考 
代码 清单 5-1。 

代码 清单 5-1 Encoding 类 公开 的 常用 编码 格式 

public static Encoding UTF8 { get; } 

public static Encoding UTF7 { get; } 

public static Encoding UTF32 { get; } 

public static Encoding Unicode { get; } 

public static Encoding BigEndianUnicode { get; } 

public static Encoding ASCII { get; } 

public static Encoding Default { get; } 


Default 获取 的 编码 由 操作 系统 的 设置 决定 。 对 于 简体 中 文 版 本 的 操作 系统 ,一 般 为 
GB2312 编码 。 

要 获取 字符 串 编码 后 的 字 节 序列 ,可 调用 GetBytes 方法 ; 而 调用 GetString 方法 则 可 
以 从 已 编码 的 字 节 序列 中 读 出 字符 串 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 System. Text 命名 空间 。 


using SYstem. Text; 
步骤 3: 声明 一 个 字符 串 变 量 并 进行 初始 化 。 


string str = "你 好 ,小 王 。"; 
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步骤 4: 对 字符 串 进行 UTF-8 编码 ,然后 输出 字 节 数组 。 


byte[ ] data = Encoding. UTF8.GetBytes(str); 
Console. WriteLine("utf -8 编码 后 的 字 节 序列 :\n{0}"，BitConverter. ToString(data)); 


步骤 5: 从 已 编码 的 字 节 数组 中 重新 读 取 字 符 串 。 


string back = Encoding. UTF8.GetString(data); 
Console. WriteLine(" 从 utf -8 编码 后 的 字 节 序列 中 读 回 字符 串 :\n{0}"， back); 


注意 : 读 取 字 符 串 时 ,使 用 的 编码 格式 一 定 要 与 编码 时 所 使 用 的 编码 格式 一 致 。 如 本 例 , 编 
码 时 使 用 的 是 UTF-8 编码 ,那么 在 读 取 字 符 串 时 也 要 使 用 UTF-8 编码 。 


步骤 6: 运行 应 用 程序 项 目 , 控 制 台 输出 内 容 如 图 5-29 所 示 。 


CNProgram Files\dotnet\dotnet.exe 到 口 x 


图 5-29 字符 串 编码 


实例 156 “字符 串 的 HTML 编码 

【导语 】 

当 字符 串 被 呈现 为 HTML 文档 内 容 时 , 某 些 特殊 字符 需要 进行 转 义 ,否则 会 与 文档 中 
的 HTML 标记 冲突 。 例 如 ,字符 串 中 出 现 的 *<” 就 必须 蔡 换 为 *&lt; ”,“>” 就 必须 替换 为 


» 


“ggts 
本 实例 将 演示 WebUitility 类 的 用 法 。 该 类 位 于 System. Net 命名 空间 下 ,其 功能 是 进 
行 字符 串 的 HTML 编码 与 解码 操作 。 
wa 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: a 量 并 进行 赋值 。 


string str = "<1> Item 1\n<2> Item 2\n<3> Item 3 & Item 4"; 


上 述 字 符 串 中 含有 与 HTML 不 兼容 的 字符 , 接 下 来 将 对 这 些 字符 进行 编码 。 
步骤 3: 对 上 面 的 字符 串 进行 HTML 编码 。 


string htmlstr = WebUtility.HtmlEncodel(str); 


步骤 4: 分 别 输出 原 字符 串 与 编码 后 的 字符 串 。 
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WriteLine( $ " 原 字符 串 :\n{str}\n"); 
WriteLine( $ "HTML 编码 后 的 字符 串 :\n{htnlstr}"); 


步骤 5: 按 下 快捷 键 F5 运行 应 用 程序 项 目 ,输出 内 容 如 图 5-30 所 示 。 


CNProgramFiesd — 口 x 


图 5-30 ”HTML 编码 


实例 157 字符 串 隐 式 转换 为 自 定 义 类 

【导语 】 

在 重 写 转换 运算 符 时 ,加 上 implicit 关键 字 可 以 实现 隐 式 转换 。 本 实例 将 通过 此 种 方 
式 实现 将 string 类 型 隐 式 转换 为 自 定义 类 的 实例 。 

假设 自 定 义 类 有 4 个 公共 属性 一 一 ID、Name、Age、City, 字 符 串 由 这 4 个 属性 的 值 组 
成 ,并 使 用 制 表 位 符 “\t” 分 隔 。 当 实现 自 定义 转换 时 ,将 通过 制 表 位 符 拆 分 字符 串 , 然 后 将 
拆 分 出 来 的 4 个 字符 串 分 别 赋 给 自 定义 类 的 属性 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 Student 类 ,假设 它 封装 了 与 学 员 有 关 的 信息 。 


class Student 


{ 
public int ID { get; set; } 
public string Name { get; set; } 
public int Age { get; set; } 
public string City { get; set; } 
} 


步骤 3: 在 Student 类 中 实现 自 定 义 隐 式 转换 ,使 得 string 实例 可 以 直接 赋值 给 
Student 变量 。 


public static implicit operator Student(string input) 
{ 
// 拆 分 字符 串 
string[ ] parts = input.Split("\t'); 
if (parts.Length != 4) 
return null; 
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return new Student 


{ 
ID = Convert.ToInt32(parts[0]), 
Name = parts[1], 
Age = Convert.ToInt32(parts[2]), 
City = parts[3] 
}; 
} 


步骤 4: 在 Main 方法 中 ,声明 一 个 string 类 型 的 变量 并 赋值 , 稍 后 将 使 用 该 字符 串 来 
测试 隐 式 转换 。 

string str = "10026\t 小 张 \t28\t 成 都 "; 

步骤 5: 声明 Student 类 型 的 变量 ,直接 把 str 变量 赋 给 它 , 会 自动 完成 隐 式 转换 。 

Student stu = str; 

步骤 6: 输出 转换 后 产生 的 Student 实例 各 个 属性 的 值 。 


WriteLine(" 学 员 信息 :"); 
WriteLine( $ "学 号 :{stu. ID}\n 学 员 姓 名 : {stu. Name}\n 学 员 年 龄 : {stu. Age}\n 所 在 城市 : { stu. 
City}"); 


步骤 7: 运行 应 用 程序 项 目 ,控制 台 输 出 结果 如 图 5-31 所 示 。 


Ss 口 X 


图 5-31 隐 式 转换 产生 的 Student 实例 


泛 型 与 集合 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 泛 型 ， 
。 数组 ; 


合 ; 


。 元 组 。 
6.1 泛 型 


实例 158 ”使 用 泛 型 参数 

【导语 】 

泛 型 的 作用 是 扩大 类 型 的 灵活 性 与 通用 性 ,在 定义 类 型 (如 类 、 接 口 ) 时 可 以 设置 命名 的 
类 型 占 位 符 , 即 泛 型 参数 。 例 如 在 声明 下 面 的 Test 类 时 指定 工 .F 两 个 占 位 符 。 


class Test <T, F> 
{ 
public Test(T a, F b) 
{ 
WriteLine(a. GetType( ). Name); 
WriteLine(b. GetType( ). Name); 


} 

TT 与 下 就 是 泛 型 参数 ,Test 类 也 就 是 泛 型 类 。 在 调用 Test 类 时 ,用 真实 的 类 型 去 替换 
泛 型 参数 ,例如 ,T 参数 替换 为 string 类 型 ,F 参数 替换 为 byte 类 型 。 

Test < string，byte> c = new Test< string, byte>("abc", 255); 

此 时 ,Test 类 的 公共 构造 函数 就 会 变 为 以 下 形式 。 


public Test( string ay byteb ){ } 
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如 果 用 int 类 型 替换 泛 型 参数 T, 用 long 类 型 替换 泛 型 参数 F, 则 Test 类 的 公共 构造 
函数 变 为 以 下 形式 。 


public Test( int alongb ) { } 


从 以 上 例子 可 以 看 出 ,使 用 泛 型 参数 可 以 增加 Test 类 的 通用 性 。 当 类 型 需要 变更 时 ， 
不 必 对 Test 类 进行 改动 ,也 不 必定 义 新 的 类 型 ,而 是 直接 用 具体 的 类 型 将 泛 型 参数 本 和 下 
替换 即 可 。 

由 于 泛 型 参数 仅仅 是 占 位 符 , 具 体 类 型 未 知 ,因此 在 指定 泛 型 参数 时 ,不 需要 指定 类 型 ， 
只 需要 给 定 一 个 有 效 命名 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Sample 类 ,该 类 带 有 一 个 名 为 K 的 泛 型 参数 ,K 所 代表 的 类 型 将 作为 
Work 方法 的 输入 参数 p 的 类 型 。 


public class Sample<K> 
{ 
public void Work(K p) 
{ 
Console. WriteLine( $ "{p. GetType().FullName, — 20}:{p}"); 
} 


在 Work 方法 内 部 ,向 控制 台 输出 参数 的 完整 类 型 名 称 及 对 应 值 。 
步骤 3: 在 Main 方法 中 ,实例 化 6 个 Sample 对 象 。 并 使 用 不 同 的 数据 类 型 蔡 换 泛 型 
参数 K。 然 后 调用 Work 方法 ,并 向 方法 传递 合适 的 参数 值 。 


Sample< string> sl = new Sample< string>(); 
sl. Work("Hello"); 

Sample< DateTime > s2 = new Sample< DateTime >(); 
5s2. Work(DateTime. Now); 

Sample< decimal > s3 = new Sample < decimal >(); 
s3. Work(0.33M); 

Sample< float> s4 = new Sample< float >(); 
s4.Work(11.954f); 

Sample< byte> s5 = new Sample < byte>(); 

s5. Work(255); 

Sample<uint > s6 = new Sample<uint >(); 

s6. Work(798652); 


向 Work 方法 传递 的 值 的 类 型 一 定 要 与 实例 化 Sample 类 时 为 泛 型 参数 K 所 指定 的 类 


型 匹配 。 例 如 ,KK 的 类 型 为 byte, 则 向 Work 方法 传递 的 必须 是 byte 类 型 的 值 , 即 0 一 255 
(包括 0 和 255) 的 整数 值 , 若 K 为 string 类 型 ,那么 传递 给 Work 方法 的 值 必须 是 字符 串 。 
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步骤 4: 按 下 F5 快捷 键 ,运行 应 用 程序 ,控制 台 输出 的 文本 如 图 6-1 所 示 。 


CANProgram Files\dotnet\dotn.. 一 口 x 


图 6-1 泛 型 参数 的 类 型 与 实例 值 


实例 159 ”实现 泛 型 接口 

【导语 】 

当 某 个 类 型 要 实现 包含 泛 型 参数 的 接口 时 ,可 以 考虑 以 下 两 种 情况 : 

(1) 在 实现 泛 型 接口 时 就 明确 泛 型 参数 的 类 型 ,即使 用 确定 的 类 型 替换 接口 中 的 泛 型 


(2) 泛 型 参数 的 类 型 依然 未 确定 ,可 以 用 当前 类 型 中 所 指定 的 泛 型 参数 去 替换 接口 中 
原 有 的 泛 型 参数 。 

本 实例 将 涉及 以 上 两 种 情况 。 

【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 带 泛 型 参数 的 接口 。 

public interface ITest<P，Q> 

{ 

void Output (P x, Q y); 

} 

泛 型 参数 P 和 Q 作为 Output 方 法 的 输入 参数 的 类 型 。 

步骤 3: 声明 Somethingl 类 ,并 且 该 类 在 实现 ITest 接口 时 ,明确 指定 ITest 接口 的 泛 
型 参数 类 型 分 别 为 int 和 double。 


public class Somethingl : ITest< int, double> 


{ 
public void Output (int x, double y) 
{ 
WriteLine("{0} — {1}", x.GetType(), x); 
WriteLine("{0} — {1}\n", y.GetType(), y); 
} 
} 


步骤 4: 声明 Something2 类 ,该 类 也 带 有 泛 型 参数 ,并 用 该 类 的 泛 型 参数 替换 ITest 接 
口 的 泛 型 参数 。 
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public class Something2 <J, K> : ITest <J, K> 
{ 
public void Output (J x, K y) 
{ 
WriteLine("{0} — {1}", x.GetType(), x); 
WriteLine("{0} — {1}\n", y.GetType(), y); 


} 
步骤 $: 在 Main 方法 中 ,实例 化 Somethingl 对 象 .并 调用 Output 方法 。 


Somethingl v1 = new Somethingl(); 
v1.0utput(500，99.88d) ; 


在 声明 Somethingl 类 的 时 候 已 经 明确 使 用 了 int 和 double 类 型 替换 ITest 接口 中 的 
泛 型 参数 ,因此 Outpnut 方法 的 第 一 个 参数 只 能 是 int 类 型 ,第 二 个 参数 只 能 是 double 类 型 。 
步骤 6: 实例 化 一 个 Something2 类 型 的 对 象 ,并 指定 泛 型 参数 为 uint 和 ushort 类 型 。 


Something2 <uint, ushort > v2 = new Something2 <uint, ushort >(); 

v2.OQutput(9009, 17); 

步骤 7: 再 实例 化 一 个 Something2 对 象 ,将 泛 型 参数 
替换 为 char 类 型 和 string 类 型 。 

Something2 < char, string > v3 = new Something2 < char, 

string>(); 

V3.0utput('c' "cat"); 

由 于 在 声明 Something2 类 的 时 候 同时 指定 了 泛 型 参 
数 , 所 以 在 实例 化 该 类 时 可 以 使 用 各 种 类 型 来 蔡 换 泛 型 


参数 。 图 6-2 调用 实现 了 泛 型 接口 的 类 
步骤 8: 运行 应 用 程序 项 目 , 屏 幕 输出 内 容 如 图 6-2 

所 示 。 
实例 160 ”限制 泛 型 参数 只 能 使 用 值 类 型 
【导语 】 


因为 证 型 参数 可 以 是 任意 类 型 ,所 以 如 果 编 译 器 仅仅 将 参数 假定 为 Object 类 型 ( 即 按 
照 Object 类 的 成 员 进行 访问 ) ,那么 代码 在 访问 某 些 特定 类 型 时 就 会 引发 编译 错误 。 

为 了 避免 引发 编译 错误 ,有 时 候 需 要 对 泛 型 参数 进行 限制 ,也 就 是 泛 型 约束 。 常 用 的 泛 
型 约束 如 下 。 

(1) class: 限制 泛 型 参数 的 类 型 必须 是 类 (引用 类 型 ) 。 

(2) struct: 限制 泛 型 参数 的 类 型 必须 是 结构 ( 值 类 型 ) 。 

(3) new(): 要 求 类 型 必须 包含 公共 的 、 无 参数 的 构造 函数 。 当 使 用 多 个 约束 时 ,new() 必 
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须 放 到 最 后 。 
(4) unmanaged: 要 求 类 型 是 非 托 管 类 型 。 此 约束 不 常用 。 
(5) 接口 或 者 基 类 : 要 求 类 型 必须 实现 指定 接口 ,或 者 必须 从 指定 类 型 派生 。 
泛 型 约束 可 以 组 合 使 用 ,例如 下 列 泛 型 类 要 求 类 型 参数 是 引用 类 型 (class) ,而 且 要 实 
现 IService 接口 。 


public class MainItem <U> where U: class, IService 


{ 


泛 型 约束 的 使 用 方法 是 在 声明 类 型 或 类 型 成 员 之 后 应 用 where 关键 字 , 然 后 才 是 类 型 
参数 的 约束 条 件 。 如 果 有 多 个 泛 型 参数 ,也 可 以 用 多 个 where 关键 字 ,格式 如 下 。 


public class SomeOne<T，S> 
where T : class, new() 
where S : ITask 

{ 


} 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 类 ,命名 为 Test, 带 有 一 个 泛 型 参数 T。 


class Test <T> 


步骤 3: 对 泛 型 参数 T 进行 约束 ,限制 只 能 是 值 类 型 , 即 类 型 为 结构 。 


class Test <T> where T : struct 


步骤 4: 在 类 中 声明 一 个 Start 方法 ,并 且 接 受 一 个 工 类 型 的 参数 。 


public void Start(T x) 


string CheckType(Type t) => t. IsValueType ? "是 ”: "不 是 "; 
TYpe type = x.GetType(); 
Console. WriteLine( $ "{type. Name} {CheckType(type)} 值 类 型 ."); 


CheckType 是 一 个 内 联 方 法 , 它 的 格式 与 方法 类 似 , 但 不 需要 指定 访问 修饰 符 , 一 般 用 
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于 实现 简单 的 逻辑 处 理 。 如 本 例 中 的 CheckType, 只 是 用 于 判断 类 型 T 是 否 为 值 类 型 ,如 
果 是 返回 字符 串 “ 是 ”, 否 则 返回 字符 串 “ 不 是 ”。 

步骤 5: 回 到 Main 方法 ,用 定义 好 的 泛 型 类 声明 一 个 变量 ,然后 创建 一 个 新 实例 。 随 
后 调用 Start 方法 ,此 时 类 型 参数 了 为 int 类 型 。 

Test< int> tv = new Test< int >(); 

tv. Start(100); 

步骤 6: 类 似 地 ,再 声明 一 个 Test 类 的 变量 并 实例 化 ,然后 调用 Start 方法 ,类 型 参数 本 
为 byte 类 型 。 


Test <byte> tq = new Test<byte>(); 
tq. Start(152); 


步骤 7: 运行 应 用 程序 项 目 , 显 示 以 下 输出 信息 。 


Int32 是 值 类 型 。 
Byte 是 值 类 型 。 


注意 ; 由 于 在 声明 Test 类 时 已 经 给 类 型 参数 本 添加 了 约束 条 件 ,所 以 在 声明 Test 类 的 变 
量 时 ,类 型 参数 只 能 使 用 值 类 型 ,不 能 使 用 引用 类 型 。 


实例 161 泛 型 方法 

【导语 】 

泛 型 方法 的 声明 方式 与 泛 型 类 相似 ,在 方法 名 称 后 直接 指定 泛 型 参数 ,而 且 也 可 以 使 用 
类 型 约束 。 

调用 泛 型 方法 时 可 分 两 种 情况 讨论 : 

(1) 如 果 类 型 参数 被 用 于 输入 参数 ,那么 在 调用 泛 型 方法 的 时 候 不 需要 明确 指定 参数 
类 型 ,编译 器 会 根据 输入 参数 的 值 推断 出 类 型 。 例 如 下 面 的 调用 代码 ,根据 传递 给 方法 参数 
的 值 ,编译 器 可 推断 出 泛 型 参数 类 型 为 string。 


obj. SetVal( "abcdefg" ); 

实际 上 ,相当 于 以 下 形式 。 

obj. SetVal < string >( "abcdefg" ); 

(2) 如 果 泛 型 参数 作为 方法 返回 值 ,那么 在 调用 方法 时 应 当 明 确 指 定 类 型 ,因为 编译 器 
不 能 推断 出 返回 值 的 类 型 。 

本 实例 将 演示 泛 型 方法 的 声明 与 调用 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
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步骤 2: 声明 两 个 类 ,分别 命名 为 A、B, 稍 后 在 调用 泛 型 方法 时 使 用 。 


public class A{} 
public class B{ } 


步骤 3: 声明 一 个 Sample 类 。 


class Sample 


{ 


} 


步骤 4: 在 Sample 类 中 声明 DoSomething 方法 ,该 方法 带 有 一 个 类 型 参数 T, 而 且 还 
包含 一 个 工 类 型 的 输入 参数 。 


public void DoSomething <T>(T p) 
where T : struct 


{ 
Console. WriteLine("{0} — {1}", p.GetType().Name, p); 
: 


类 型 参数 T 被 限制 为 值 类 型 ,类 型 为 结构 。 
步骤 5: 声明 GetSomething 方法 ,此 方法 带 有 类 型 参数 T, 方 法 的 返回 值 类 型 也 为 。 


public T GetSomething<T>() 
where T : class, new() 

{ 
return new T(); 


} 


在 方法 中 ,为 了 能 够 通过 new 运算 符 返回 T 类 型 的 实例 ,对 类 型 做 了 约束 ,T 必须 是 
引用 类 型 (类 ) ,而 且 具 备 无 参数 的 公共 构造 函数 。 
步骤 6: 在 Main 方法 中 ,实例 化 Sample 类 。 


Sample s = new Sample(); 


步骤 7: 调用 Sample 类 实例 的 DoSomething 方法 ,由 于 类 型 参数 在 方法 中 作为 输入 参 
数 的 类 型 ,编译 器 可 以 根据 赋值 推断 类 型 ,因此 无 须 明确 指定 类 型 。 


// char 

s. DoSomething( 'z'); 

// byte 

s. DoSomething( (byte)5); 
// double 

s. DoSomething(6. 3333d); 
// int 

s. DoSomething(777); 
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步骤 8: 调用 GetSomething 方法 ,由 于 类 型 参数 作为 返回 值 的 类 型 ,无 法 自动 推断 类 
型 ,所 以 必须 明确 指定 T 的 类 型 。 


R xa = s.GetSomething<A>(); 
B xb = s.GetSomething<B>(); 


实例 162 ”将 泛 型 参数 限制 为 枚 举 类 型 


【导语 】 

虽然 将 泛 型 参数 约束 为 枚 举 类 型 的 情形 不 多 见 ,在 实际 开发 中 也 不 常用 ,但 是 可 以 将 其 
作为 一 种 开发 技巧 进行 了 解 。 实 现 方法 是 把 约束 条 件 设 定 为 System. Enum 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Program 类 中 添加 一 个 静态 方法 。 该 方法 带 有 一 个 泛 型 参 
数 工 ,并 将 类 型 T 约束 为 枚 举 类 型 ,其 输入 参数 的 类 型 也 是 工 。 


static (string, int) CallTest <T>(T p) 
where T: Enum 
{ 
// 获取 常量 名 称 
string name = Enum.GetName(p.GetType(), p); 
// 获取 常 值 
int value = Convert.ToInt32(p); 
return (name, value); 


} 

方法 的 返回 类 型 是 元 组 ,里 面包 含 一 个 string 类 型 的 值 以 及 一 个 int 类 型 的 值 。 在 方 
法 体内 部 ,通过 Enum. GetName 方法 得 到 传递 给 方法 参数 的 枚 举 常量 的 名 称 ; 而 如 果 需 要 
获取 枚 举 值 ,直接 将 其 转换 为 int 类 型 即 可 。 

步骤 3: 为 了 便于 稍 后 测试 ,可 以 声明 一 个 枚 举 类 型 。 


public enum Oper 
{ 


Open = 5, 
Close = 12, 
Reset = 6 


} 
步骤 4: 在 Main 方法 中 ,测试 CallTest 方法 的 调用 。 
(string Name, int Val) res = CallTest(Oper. Open); 


在 接收 方法 的 返回 值 时 ,可 以 为 元 组 中 的 项 重新 命名 ,例如 在 本 例 中 ,将 string 类 型 的 
项 命名 为 Name, 将 int 类 型 的 项 命名 为 Val。 
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步骤 5: 在 控制 台中 输出 结果 。 

Console. WriteLine( $" 枚 举 常量 名 :{res. Name} ,常量 值 : {res. Val}"); 
步骤 6: 运行 应 用 程序 项 目 ,屏幕 的 输出 内 容 如 下 。 
枚 举 常 量 名 :0pen, 常量 值 :5 


实例 163” 泛 型 参数 的 输入 与 输出 


【导语 】 
如 果 泛 型 参数 不 带 任何 修饰 符 ,那么 在 分 配对 象 实例 时 ,类 型 参数 只 能 是 固定 的 类 型 。 
例如 以 下 形式 。 


Class <A>x = new Class <A>(); 
假设 B 类 从 A 类 派生 , 则 分 配 以 下 对 象 实例 时 会 报错 。 
Class <A> x = new Class <B>(); 


因为 泛 型 参数 未 使 用 任何 修饰 符 ,使 得 参数 类 型 是 固定 的 。 声 明 变 量 时 使 用 的 是 A 类 
型 ,而 分 配对 象 实例 时 使 用 的 是 B 类 型 ,前 后 不 一 致 ,会 出 现 编译 错误 。 

要 使 泛 型 中 的 类 型 参数 成 为 变 体 ,一 般 可 以 使 用 两 个 修饰 符 一 一 in 和 out。 带 in 修饰 
符 的 是 “输入 类 型 ", 此 类 型 参数 一 般 用 于 委托 或 方法 的 输入 参数 ,属于 逆 变 。 带 out 修饰 符 
的 是 “输出 类 型 ,一般 用 于 委托 或 方法 的 返回 值 ,属于 协 变 。 

泛 型 的 输入 /输出 类 型 参数 只 能 用 于 委托 和 接口 两 种 数据 类 型 ,不 能 用 于 类 与 结构 ,而 
且 作 为 类 型 参数 的 类 型 不 能 是 值 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 类 , 稍 后 用 于 测试 。 


public class Ball { } 

public class FootBall : Ball { } 

FootBall 类 从 Ball 类 派生 。 按 照 隐 式 转换 的 要 求 ,FootBall 类 的 实例 可 以 赋值 给 使 用 
Ball 类 型 声明 的 变量 。 

步骤 3: 声明 两 个 带 可 变 类 型 参数 的 泛 型 接口 。 

public interface ITestl1<inT>{} 

public interface ITest2<out T>{} 

在 ITestl 接口 中 ,TT 类 型 参数 使 用 了 in 修饰 符 .表示 它 是 一 个 输入 类 型 , 即 逆 变 。 在 
ITest2 接口 中 ,T 类 型 参数 使 用 了 out 修饰 符 , 表 示 该 类 型 将 作为 输出 参数 (返回 值 ), 即 
协 变 。 
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步骤 4: 声明 两 个 类 ,分 别 实现 ITestl 和 ITest2 接口 。 

public class Testl <T> : ITestl1 <T>{} 

public class Test2<T> : ITest2<T>{} 

步骤 5: 在 Main 方法 中 用 ITestl 接口 声明 变量 ,类 型 参数 为 FootBall 类 ,然后 用 
Testl 类 的 新 实例 进行 赋值 ,类 型 参数 为 Ball 类 。 


ITestl <FootBall > tl = new Testl1<Ball>(); 


上 述 情况 属于 逆 变 。tl 变量 的 泛 型 参数 只 能 接受 FootBall 类 型 ,而 它 所 引用 的 实例 的 
泛 型 参数 则 可 以 接受 Ball 和 FootBall 两 个 类 型 ,可 以 看 到 ,赋值 之 后 实例 能 分 配 的 兼容 性 
变 小 了 , 当 通 过 tl 变量 调用 相关 成 员 时 ,只 能 使 用 FootBall 类 。 

步骤 6: 用 ITest2 接口 声明 变量 ,并 指定 泛 型 参数 为 Ball 类 ,使 用 Test2 实例 赋值 的 ， 
泛 型 参数 为 FootBall 类 。 


ITest2 < Ball > t2 = new Test2 < FootBall >(); 


变量 t2 能 够 接受 Ball 和 FootBall 两 种 类 型 的 返回 值 ,而 它 所 引用 的 实例 只 能 返回 
FootBall 类 型 的 对 象 。 当 使 用 t2 变量 调用 相关 成 员 时 ,由 于 ITest2 < Ball > 的 分 配 兼 容 性 
较 大 ,能 够 顺利 引用 Test2 < FootBall > 实例 所 返回 的 对 象 ,此 情况 属于 协 变 。 


实例 164 ”在 委托 类 型 中 使 用 泛 型 


【导语 】 

框架 类 库 自 带 的 Action 和 Func 委托 都 属于 泛 型 委托 。 其 中 ,Action 委托 适 配 返 回 类 
型 为 void 的 方法 ,参数 个 数 为 0 到 16 个 , 泛 型 参数 都 使 用 了 in 修饰 符 ; Func 委托 的 输入 
参数 个 数 为 0 到 16 个 ,并 带 有 一 个 输出 参数 (其 泛 型 参数 使 用 out 修饰 符 ) ,这 个 输出 参数 
就 是 方法 的 返回 值 。Func 委托 用 于 匹配 返回 非 void 类 型 的 方法 。 

在 开发 过 程 中 ,不 仅 可 以 使 用 现成 的 Action 和 Func 委托 ,开发 人 员 也 可 以 声明 自己 所 
需要 的 泛 型 委托 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 委托 类 型 ,并 带 有 泛 型 参数 。 


public delegate R MyTestDel < in Al, in A2, out R>(Al m, A2 n) 
where Al:struct 


where A2:struct; 


其 中 ,Al、A2 是 输入 参数 ,R 是 输出 参数 ,并 且 约 束 Al 和 A2 类 型 必须 是 值 类 型 。 
步骤 3: 用 上 面 声 明 的 委托 定义 变量 ,并 初始 化 。 


MyTestDel < int, byte, string> test = (a, b) => 
{ 
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string ret = $ "type = {a.GetType(). Name}, value = {a}\ntype = {b. GetType(). 
Nanme}, value = {b}"; 
return ret; 
}; 
通过 填充 类 型 参数 ,使 得 委托 实例 的 输入 参数 分 别 为 int 
和 byte, 返 回 类 型 为 string。 
步骤 4: 尝试 调用 委托 实例 ,并 将 调用 结果 输出 到 控制 台 。 


Console, WriteLine(test(350, 27)); 图 6-3 泛 型 委托 调用 结果 
步骤 5: 运行 应 用 程序 项 目 ,得 到 的 输出 结果 如 图 6-3 所 示 。 


实例 165 ”将 抽象 类 作为 类 型 约束 

【导语 】 

将 泛 型 参数 约束 为 抽象 类 或 者 接口 ,可 以 有 效 规范 对 类 型 实例 的 访问 ,这 在 实际 开发 中 
比较 实用 。 如 果 不 给 类 型 参数 添加 约束 ,那么 在 默认 情况 下 编译 器 就 以 Object 类 的 成 员 进 
行规 范 ,这 会 带 来 诸多 不 便 。 

然而 如 果 使 用 抽象 类 或 者 接口 来 约束 类 型 参数 ,那么 在 访问 参数 实例 时 就 很 方便 了 。 
例如 声明 一 个 接口 ,名 为 IService, 接 口中 明确 声明 两 个 方法 一 一 Open 和 Close。 在 泛 型 参 
数 中 添加 约束 ,要 求 类 型 必须 实现 IService 接口 。 在 这 种 情况 下 ,访问 泛 型 参数 实例 的 代码 
不 需要 关心 有 多 少 个 类 实现 了 IService 接口 ,因为 不 管 是 哪个 类 ,只 要 它 实现 了 该 接口 , 必 
然 会 包含 Open 和 Close 这 两 个 方法 ,如 此 一 来 ,代码 只 需要 调用 方法 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 为 了 便于 稍 后 测试 , 先 声明 一 个 抽象 类 Animal, 它 表示 所 有 动物 ,同时 包含 一 
个 抽象 的 CheckIn 方法 。 


/// < summary> 

// 公共 基 类 

/// </summary> 

public abstract class Animal 


{ 
public abstract void CheckIn(); 


’ 

所 有 从 Animal 类 派生 的 类 都 必须 实现 CheckIn 方法 。 

步骤 3: 声明 4 个 新 类 ,都 实现 Animal 抽象 类 , 详 见 代码 清单 6-1。 
代码 清单 6-1 4 个 实现 Animal 类 的 新 类 


/// < summary> 


/// 猫 山 
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/// </summary> 
public class Meerkat : Animal 
{ 
public override void CheckIn() 
{ 
Console. WriteLine(" 这 是 猫 央 。\n"); 
} 
} 


/// < summary> 
/// 狐狸 
/// </summary> 
public class Fox : Animal 
! 
public override void CheckIn() 
1 
Console. WriteLine(" 这 是 狐狸 。\n"); 
} 
} 


/// < summary> 
/// 鸡 
/// </summary> 
public class Chicken : Animal 
{ 
public override void CheckIn() 
{ 
Console. WriteLine(" 这 是 鸡 。\n"); 
} 
} 


/// < summary> 
/// 雹 塌 
/// </ summary> 
public class Quail : Animal 
{ 
public override void CheckIn() 
{ 
Console. WriteLine(" 这 是 更 竟 。\n"); 
} 
} 


步骤 4: 声明 一 个 泛 型 接口 ,将 类 型 参数 标注 为 输入 参数 ,这 样 可 以 在 后 续 使 用 中 支持 
传递 不 同 派生 程度 的 类 。 
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public interface ITest< in T> 
{ 

void DoWork(T pr); 
} 


步骤 5: 声明 泛 型 类 ,并 实现 上 面 的 泛 型 接口 ,将 类 型 参数 约束 为 必须 是 从 Animal 派 
生 的 类 。 


public class TestAnl <T> : ITest <T> 
where T : Animal 
{ 
public void DoWork(T pr) 
{ 
// CheckIn 方法 是 在 抽象 类 中 定义 的 
// 所 有 实现 该 抽象 类 的 类 型 都 能 访问 
pr. CheckIn( ); 


} 


步骤 6: 使 用 ITest 接口 声明 一 个 变量 ,然后 使 用 TestAnl 类 的 新 实例 对 其 初始 化 ,类 
型 参数 使 用 Animal 类 ,这 样 做 能 够 增加 调用 DoWork 方法 的 灵活 性 ,能 够 向 该 方法 传递 各 
种 Animal 类 的 子 类 实例 。 


ITest <Animal > 七 = new TestAn] < Animal >(); 


步骤 7: 调用 DoWork 方法 ,依次 将 Animal 类 的 4 
国 cNprogram Files.. 
个 派生 类 的 实例 传递 进去 。 是 狐狸 


t. DoWork (new Fox() ) 

t. DoWork(new Meerkat( ) ); 
七 . DoWork(new Quail()); 
七 . DoWork(new Chicken( ) ) ; 


步骤 8: 按 F5 快捷 键 运行 实例 ,控制 台 输 出 结果 如 网 _ 
图 6-4 所 示 。 图 6-4 4 个 子 类 的 调用 结果 


6.2 数组 


实例 166 ”四 种 方式 初始 化 数组 实例 

【导语 】 

在 创建 数组 实例 时 ,一 般 有 四 种 方式 可 以 对 数组 实例 中 的 元 素 进行 初始 化 。 
(1) 实例 化 数组 时 明确 指定 元 素 个 数 , 并 在 创建 实例 后 ,依次 给 每 个 元 素 赋值 。 


用 。 


9 
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int[] x = new int[3]; 


x[0] = 1; 
x[1] = 2; 
[2] = 37 


(2) 在 创建 数组 实例 时 明确 指定 元 素 个 数 ,随后 直接 初始 化 。 

int[] v = new int[3] { 1, 8, 3 }; 

(3) 在 实例 化 数组 对 象 时 不 指定 元 素 个 数 ,而 是 由 初始 化 的 元 素来 确定 元 素 个 数 。 
int[] t = new int[] { 33, 4, 105, 80 }; 

(4) 这 是 第 三 种 方式 的 简写 ,实例 化 数组 时 直接 用 元 素来 填充 。 

int[] £ = { 16, 27, 63, 91 }; 


本 实例 将 演示 使 用 以 上 四 种 方式 来 初始 化 数组 对 象 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 新 的 数组 实例 ,并 对 元 素 逐 一 初始 化 。 


string[ ] arrl = new string[4]; 


arrl[0] = "how"; 
arrl[1] = "old"; 
arrl[2] = "are"; 
arrl[3] = "you"; 


步骤 3: 在 创建 数组 实例 的 同时 对 元 素 进行 初始 化 ,数组 大 小 已 确定 。 
double[ ] arr2 = new double[2] { 0.0012d, 6.008d }; 

步骤 4: 数组 大 小 未 确定 ,通过 填充 元 素来 决定 其 大 小 。 

long[ ] arr3 = new long[] { 355558L，70001L，6969221L }; 

步骤 5: 数组 大 小 未 确定 ,通过 简化 语法 使 用 数组 元 素 直 接 填充 。 


uint[] arr4 = { 3608, 270, 4256, 8088, 6120 }; 


实例 167 创建 二 维 数组 


【导语 】 
日 常 开 发 中 ,一 维 数组 的 使 用 频率 最 高 ,偶尔 会 用 到 二 维 数组 ,二 维 以 上 的 数组 极 少 使 
一 维 数组 的 声明 方式 是 在 类 型 后 面 跟随 一 对 空 的 中 括号 ; 二 维 数组 的 声明 方式 就 是 在 


括号 中 添加 一 个 逗号 (英文 ); 三 维 数组 的 声明 方式 就 是 中 括号 中 添加 两 个 逗号 ,其 他 维 
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例如 ,以 下 代码 声明 一 个 元 素 为 char 类 型 的 二 维 数 组 。 
char[, ] chs; 

以 下 代码 声明 三 维 数组 。 

char[,, ] chs; 


多 维 数组 的 元 素 个 数 为 每 个 维度 中 元 素 个 数 的 乘积 。 例 如 ,int[2,3,5] 有 三 个 维度 ,元 


素 个 数 二 2X3X5, 即 30 个 元 素 。 


【操作 流程 】 
步骤 1: 创建 一 个 控制 台 应 用 项 目 。 
步骤 2: 声明 一 个 二 维 数组 ,然后 实例 化 。 


float[,] da = new float[5, 3]; 


步骤 3: 为 数组 中 的 元 素 赋值 。 


da[0, 0] = 0.1101f; 
da[0, 1] = 0.1102f; 
da[0, 2] = 0.1103f; 
da[1, 0] = 0.1212f; 
da[1, 1] = 0.1105f; 
da[1，2] = 0.1204f; 
da[2, 0] = 0.1015f; 
da[2，1] = 0.1217f; 
da[2, 2] = 0.1005f; 
da[3, 0] = 0.1705f; 
da[3, 1] = 0.1303f; 
da[3, 2] = 1.1002f; 
da[4, 0] = 2.1217£; 
da[4, 1] = 2.3015f; 
da[4, 2] = 2.2165f; 


访问 二 维 数组 中 的 元 素 时 ,第 一 个 索引 定位 第 一 维度 的 位 置 ,第 二 个 索引 定位 第 二 维度 


的 位 置 ,该 数组 对 象 共有 15 个 元 素 。 


步骤 4: 通过 for 循环 ,输出 二 维 数组 中 所 有 元 素 的 值 。 


for(int x = 0; x<5; x++) 
{ 
for(inty = 0; y<3; y++) 
{ 
Console. Write( $"[{x}, {y}] : {da[x, y]} "); 
} 


Console. Write("\n"); 
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由 于 是 二 维 数组 ,需要 赃 套 两 个 for 循环 。 外 层 for 循环 用 于 访问 第 一 维度 的 元 素 ,内 


层 for 循环 用 于 访问 第 二 维度 的 元 素 。 
步骤 5: 运行 应 用 程序 项 目 ,控制 台 上 的 输出 如 图 6-5 所 示 。 


图 6-5 输出 二 维 数组 中 的 元 素 


实例 168 ”使 用 简化 语法 初始 化 多 维 数组 
【导语 】 
- 维 数组 初始 化 的 简化 语法 比较 简单 ,只 需要 一 对 大 括号 将 元 素 括 起 来 ,例如 以 下 
格式 。 
double[] a = { 0.00015d, 0.00000058d, 0.0012d }; 
多 维 数组 初始 化 的 方法 类 似 ,只 是 在 大 括号 中 需要 嵌 套 大 括号 , 榜 套 的 层 数 与 数组 的 维 


数 相 同 。 
例如 ,要 初始 化 二 维 数组 int[2,3] ,需要 嵌 套 两 层 大 括号 。 方 法 是 在 最 外 层 大 括号 中 髓 


套 2 个 大 括号 ,而 每 个 大 括号 中 包含 3 个 元 素 , 格 式 如 下 。 
int[,] vk = 
{1,2,3}, 
1 5 6 
但 是 ,不 能 写成 以 下 形式 。 


int[,] b = 


{1,2}, 

{3,4}, 

{5,6} 
因为 这 样 就 会 变 成 intL[3,2] 了 ,虽然 元 素 的 总 数 都 是 6, 但 数组 的 结构 是 不 同 的 。 
再 例如 ,三 维 数组 int[2,3,2] 的 元 素 总 数 为 12, 类 似 地 ,因为 有 三 个 维度 ,所 以 要 榜 套 
三 层 大 括号 。 顶 层 大 括号 封装 整个 数组 对 象 , 它 里 面包 含 两 个 大 括号 , 即 为 第 二 层 ; 第 二 层 
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中 的 每 个 大 括号 里 面 都 包含 三 个 大 括号 , 即 为 第 三 层 ; 在 第 三 层 中 ,每 个 大 括号 里 面 都 包含 
两 个 int 类 型 的 元 素 。 代 码 如 下 。 


int[,,]c= 
{ 
{ 
t WO 起用 
{12, 13}, 
t Yd 


区 本 
{ 33, 34 }， 
{ 35, 36 } 


}; 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 用 简化 语法 初始 化 一 个 二 维 数组 。 


long[,] a = 
{ 


340001, 340002, 340003, 340006 
}, /0 
{ 
7874225, 724435, 6868000, 602500 
ji 
{ 
552558, 201112, 7800002, 3200025 
}，//2 
{ 
5800001, 5800002, 57000003, 57000021 
jw 
{ 
1320002, 1320005,1320006, 1320008 
},174 
{ 
6006001, 97900047, 8900523, 36554225 
} //5 
}; 


该 数组 为 longL6,4], 共 24 个 元 素 。 
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步骤 3: 初始 化 一 个 三 维 数组 。 


short[,,] b = 
{ 
{ 
{ 
20,14,15,61,62 
Bia 
{ 
8,54,25,81,9 
] /AL 
{ 
32,33, 34, 35, 36 
Ja 
{ 
43,44, 45, 46, 47 
hjys 
},/70 
{ 
{ 
99,98,97,96,95 
},//0 
‘ 
84, 83,82, 81,80 
} /AL 
100,101,102,103,104 
}，//2 
{ 
151,152,153,154, 155 
FW/3 
EA 
}; 


该 数组 为 三 维 数组 short[2,4,5], 共 40 个 元 素 。 
步骤 4: 将 以 上 两 个 数组 对 象 的 元 素 输出 到 控制 台 。 


Console. WriteLine( $ "数组 {nameof(a)} 有 {a. Length} 个 元 素 , 它 们 分 别 是 :"); 
foreach(var x in a) 
{ 
Console. Write("{0} ", x); 
} 
Console. WriteLine( $"\n\n 数 组 {nameof(b)} 有 {b.Length} 个 元 素 , 它 们 分 别 是 :"); 
foreach(var x in b) 
{ 
Console. Write( $ "{x} "); 
} 


198 二 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


步骤 5: 运行 应 用 程序 ,控制 台 的 输出 内 容 如 图 6-6 所 示 。 


图 6-6 输出 多 维 数组 中 的 元 素 


实例 169 ”使 用 Array 类 创建 数组 实例 


【导语 】 

创建 数组 实例 ,不仅 可 以 使 用 基于 编程 语言 的 表达 式 ,还 可 以 使 用 .NET 中 的 内 置 类 型 
来 实现 。Array 类 是 所 有 数组 类 型 的 隐 式 基 类 , 它 与 代码 中 所 使 用 的 数组 实例 之 间 的 继承 
关系 是 由 编译 器 来 完成 的 ,开发 人 员 不 需要 编写 实现 代码 。 

Array 类 公开 CreateInstance 静态 方法 ,调用 该 方法 后 直接 产生 一 个 新 的 数组 实例 , 虽 
然 在 方法 签名 中 它 的 返回 值 类 型 是 Array, 但 在 运行 阶段 调用 时 , 它 会 返回 数组 对 象 的 实际 
类 型 。 因 此 在 调用 Createlnstance 方法 之 后 , 既 可 以 将 其 返回 的 对 象 强制 转换 为 实际 的 数 
组 类 型 来 操作 ,也 可 以 直接 调用 Array 类 的 实例 方法 进行 操作 ,例如 可 以 调用 SetValue 方 
法 在 数组 的 指定 索引 处 设置 元 素 ,或 调用 GetValue 方法 获取 指定 索引 处 的 元 素 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 CreateInstance 方法 产生 一 个 double 数组 。 


double[ ] a = (double[ ])Array.CreateInstance(typeof(double), 3); 


CreateInstance 方法 的 elementType 参数 用 于 指定 数组 元 素 的 类 型 ,此 处 为 double 类 
型 ; 后 面 的 参数 用 于 指定 每 个 维度 的 长 度 ( 即 元 素 个 数 ) 。 由 于 该 数组 为 一 维 数组 ,因而 3 
表示 该 数组 将 包含 3 个 元 素 。 

步骤 3: 为 数组 的 每 个 元 素 赋值 。 

a[0] = 656.3775d; 


a[1] 12. 399d; 
a[2] 800.187d; 


步骤 4: 调用 CreateInstance 方法 创建 一 个 二 维 数组 。 


byte[l,] b = (byte[, ])Array. CreateInstance(typeof(byte), 5, 4); 
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步骤 5: 为 数组 中 各 元 素 赋值 。 


0, 0] 


0, 


201; 
202; 
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实例 170 SetValue 方法 与 GetValue 方法 


【导语 】 

除了 在 代码 中 通过 语言 表达 式 直 接 操作 数组 外 ,还 可 以 通过 Array 类 的 一 些 成 员 方 法 
来 操作 数组 ,较为 典型 的 是 设置 或 获取 数组 的 元 素 。 

SetValue 方法 在 数组 对 象 的 指定 索引 处 设置 元 素 , 相 应 地 ,GetValue 方法 可 以 获取 指 
定 索 引 处 的 元 素 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 CreateInstance 方法 产生 数组 实例 。 


Array arr = Array.CreateInstance(typeof(string), 7); 
步骤 3: 为 数组 对 象 设置 元 素 。 


arr. SetValue( "星期 日 ", 0); 
arr. SetValue(" 星 期 一 ", 1); 
arr. SetValue(" 星 期 二 ",2); 
arr. SetValue(" 星 期 三 "，3); 
arr. SetValue(" 星 期 四 "，4); 
arr. SetValue(" 星 期 五 "，5); 
arr. SetValue(" 星 期 六 "，6); 
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步骤 4: 依次 输出 数组 中 的 元 素 。 调 用 GetValue 方法 获取 与 索引 相对 应 的 元 素 。 
Console. WriteLine(" 此 数组 有 {0} 个 元 素 ."，arr.Length); 
Console. WriteLine(" 这 些 元 素 分 别 是 :"); 

System. Text. StringBuilder strbd = new System. Text. StringBuilder(); 
for(int i = 0; i<arr.Length; i++) 


{ 


strbd. Append(arr. GetValue(i) + " "); 


} 
Console. WriteLine(strbd) ; 


图 6-7 GetValue 方 法 


获取 数组 元 素 
步骤 5: 运行 应 用 程序 ,屏幕 输出 的 信息 如 图 6-7 所 示 。 
实例 171 获取 某 个 维度 的 元 素 个 数 
【导语 】 
每 个 数组 实例 都 有 两 个 实例 方法 ,可 以 获取 到 数组 中 指定 维度 的 元 素 个 数 。 它 们 分 
别 是 : 


int GetLength( int dimension); 

long GetLongLength( int dimension) 
其 中 ,dimension 参数 用 于 指定 维 数 , 计 数 从 0 开始 , 即 第 一 维度 为 0, 第 二 维度 为 1, 第 三 维 
度 为 2, 依 次 类 推 。 

两 个 方法 的 作用 相同 ,都 是 获取 特定 维度 上 的 元 素 个 数 。 带 “Long ”的 方法 主要 在 当 数 
组 中 元 素 个 数 超出 32 位 整数 的 上 限时 使 用 ,一 般 调 用 GetLength 即 可 。 


注意 : 数组 实例 的 Length 或 LongLength 属性 获取 的 是 数组 中 所 包含 元 素 的 总 数 ,不 考虑 
维度 。 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 创建 一 个 三 维 数组 并 初始 化 。 
int[,,]a= 


{ 
{ 


605, 621, 319, 24 


703, 105, 94, 8 
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30, 252, 4502, 2 


} 
}, 
{ 
{ 
71685, 1 12; 38 
}, 
2 
109, 408, 216, 5 
}, 
{ 
562, 306, 54, 37 
} 


) 
步骤 3: 分 别 获取 三 个 维度 上 元 素 的 个 数 ,并 进行 输出 。 


// 获取 第 一 维度 的 元 素 个 数 

int len = a.GetLength(0); 

Console. WriteLine( $ "第 一 维度 有 {1en} 个 元 素 。"); 
// 获取 第 二 维度 的 元 素 个 数 

len = a.GetLength(1); 

Console. WriteLine( $ "第 二 维度 有 {len} 个 元 素 ."); 
// 获取 第 三 维度 的 元 素 个 数 

len = a.GetLength(2); 

Console. WriteLine( $ "第 三 维度 有 {len} 个 元 素 。"); 


步骤 4: 输出 整个 数组 的 元 素 总 数 。 


图 6-8 输出 数组 中 各 
Console. WriteLine( $ "整个 数组 共有 {a. Length} 个 元 素 。"); 维度 的 元 素数 量 


步骤 5: 运行 应 用 程序 ,输出 信息 如 图 6-8 所 示 。 
实例 172 动态 调整 数组 的 大 小 


【导语 】 
Array 类 有 一 个 静态 方法 名 为 Resize, 其 方法 格式 如 下 。 


static void Resize <T>(ref T[ ] array, int newSize); 


它 是 一 个 泛 型 方法 ,类 型 参数 T 指定 数组 元 素 类 型 ,newSize 参数 设 定数 组 的 新 容量 。 
实际 上 ,数组 实例 一 旦 初始 化 , 它 的 大 小 是 固定 的 ,不 可 修改 。Resize 方法 的 实现 原理 是 创 
建新 的 数组 实例 ,并 将 大 小 设置 为 newSize, 然 后 把 array 中 现 有 的 元 素 复 制 到 新 实例 中 ,并 
通过 引用 (参数 带 有 ref 修饰 符 ) 让 array 参数 引用 新 创建 的 数组 实例 ,这 样 就 达到 了 动态 调 
整数 组 大 小 的 目的 。 因 此 ,调整 数组 大 小 后 就 创建 了 一 个 全 新 的 实例 , 原 有 的 实例 被 丢弃 。 
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【操作 流程 

步骤 1: 创建 控制 台 应 用 项 目 。 

步骤 2: 声明 一 个 double 类 型 的 数组 ,并 进行 赋值。 

double[ ] arr = { 0.001d, 0.000025d, 0.3135d }; 

步骤 3: 上 面 数 组 实例 包含 3 个 元 素 , 大 小 为 3。 现 
在 把 数组 大 小 改 为 5。 


Array. Resize(ref arr, 5); 

步骤 4: 运行 应 用 程序 ,控制 台 输 出 内 容 如 图 6-9 
所 示 。 

实例 173 反 转 数组 

【导语 】 

Reverse 方法 支持 将 数组 中 元 素 的 顺序 反 转 。 反 转 是 基于 数组 元 素 的 当前 顺序 ,例如 

-个 整 型 数组 的 当前 顺序 为 1.2、3, 那 么 反 转 后 的 顺序 为 3、2、 

反 转 可 分 为 两 种 情况 : 一 种 是 把 数组 中 所 有 元 素 的 顺序 
元 素 的 顺序 反 转 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 一 个 字符 串 数 组 。 


6-9 数组 大 小 调整 前 后 的 对 比 


; 另 一 种 是 把 数组 中 部 分 


string[] a = { "ab"，"cd"，"ef"，"gh" }; 
步骤 3: 对 以 上 数组 中 的 所 有 元 素 进行 全 部 反 转 。 
Array. Reverse(a); 
步骤 4: 再 创建 一 个 int 数组 。 
1 
步骤 5: 对 以 上 数组 进行 部 分 反 转 ,从 第 4 个 元 素 开始 , 反 转 4 个 元 素 。 
Array. Reverse(b, 3, 4); 
CAprogramFiles\dotnedonet. — OD Xx 第 4 个 元 素 是 3, 从 此 处 起 连续 4 个 元 素 , 即 
”3,4、5,6, 把 它们 反 转 后 就 是 6.5、4、3, 而 0、1、2、 
7、8 这 几 个 元 素 的 位 置 是 不 变 的 ,因此 反 转 后 的 
数组 应 为 0、1、2、6、5、4、3、7、8。 

* 步骤 6: 运行 应 用 程序 ,输出 内 容 如 图 6-10 
图 6-10 数组 反 转 前 后 对 比 所 示 。 
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实例 174 查找 符合 条 件 的 元 素 


【导语 】 

有 两 种 方法 可 以 查找 数组 中 满足 特定 条 件 的 元 素 。 

第 一 种 方法 是 查找 单个 元 素 。 执 行程 序 会 逐一 验证 数组 中 的 元 素 , 一 旦 遇 到 符合 条 件 
的 元 素 ,就 马上 将 该 元 素 返 回 。 无 论 数 组 中 有 多 少 个 元 素 符合 查找 条 件 ,代码 只 会 返回 第 一 
个 找到 的 元 素 。 这 种 查找 方式 可 以 调用 Find 方法 完成 。 

第 二 种 方法 是 把 数组 中 所 有 符合 条 件 的 元 素 重 新 组 合 为 一 个 新 的 数组 实例 ,并 返回 给 
代码 调用 者 。 这 种 方式 可 以 通过 调用 FindAll 方法 来 完成 。 

不 论 是 Find 方法 还 是 FindAll 方法 ,都 带 有 一 个 委托 类 型 的 参数 一 一 Predicate, 该 委 
托 的 定义 如 下 。 


delegate bool Predicate< in T>(T obj) 


输入 参数 obj 可 通过 泛 型 参数 来 确定 类 型 ,在 与 该 委托 绑 定 的 方法 中 ,开发 人 员 可 以 根 
据 实际 需求 编写 代码 ,对 obj 参数 传递 的 对 象 进行 验证 ,如 果 符合 条 件 就 返回 true, 和 否则 返 
回 false。 

在 Find 方法 或 者 FindAll 方法 中 ,执行 程序 会 为 数组 中 的 每 个 元 素 调用 一 次 Predicate 实 
例 ,并 把 此 元 素 传递 给 obj 参数 。 只 要 调用 委托 的 结果 返回 true, 就 表示 它 就 是 要 查找 的 元 素 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 WorkItem 类 ,假设 它 表 示 某 个 生产 过 程 中 一 道 工 序 的 基本 信息 。 


public class WorkItem 

{ 
public int ID { get; set; } 
public string Title { get; set; } 
public DateTime StartTime { get; set; } 
public DateTime EndTime { get; set; } 

} 


其 中 ,StartTime 属性 表示 工序 的 开始 时 间 ,EndTime 属性 表示 工序 的 结束 时 间 。 
步骤 3: 实例 化 一 个 WorkItem 数组 ,并 填充 6 个 元 素 , 详 见 代码 清单 6-2。 


代码 清单 6-2 ”初始 化 WorkItem 数组 


WorkItem[ ] items = 
{ 
new WorkItem 
{ 
ID=1, 
Ti = ?Ty 


二 


步骤 4: 查找 开始 时 间 晚 于 2018 年 7 月 15 日 的 工序 。 此 处 使 用 Find 方法 ,虽然 原来 
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StartTime = new DateTime(2018,7,1,8,36,0), 
EndTime = new DateTime(2018,7,2,17,30,0) 
}, 
new WorkItem 
{ 
ID = 2, 
Title = "工序 2"， 
StartTime = new DateTime(2018, 7, 2, 10, 15, 0), 
EndTime = new DateTime(2018, 7, 5, 18, 0, 0) 
}, 
new WorkItem 
{ 
ID = 3, 
Title = "工序 3"， 
StartTime = new DateTime(2018, 7, 1, 15, 25, 0), 
EndTime = new DateTime(2018, 7, 12, 17, 0, 0) 
}, 
new WorkItem 
{ 
ID = 4, 
Title = "工序 4"， 
StartTime = new DateTime(2018, 7, 14, 9, 16, 0), 
EndTime = new DateTime(2018, 7, 20, 8, 20, 0) 
}, 
new WorkItem 
{ 
ID=5, 
Title = "工序 5"， 
StartTime = new DateTime(2018, 7, 23, 9, 10, 0), 
EndTime = new DateTime(2018, 7, 28, 15, 32, 0) 
}, 
new WorkItem 
{ 
ID = 6, 
Title = "工序 6"， 
StartTime = new DateTime(2018, 7, 18, 9, 11, 0), 
EndTime = new DateTime(2018, 7, 25, 16, 45, 0) 


的 数组 中 有 多 个 元 素 符合 条 件 ,但 只 返回 最 先 找到 的 那个 。 


WorkItem res = Array.Find(items, i => 


{ 


D); 


DateTime condition = new DateTime(2018, 7, 15); 
if (i.StartTime > condition) 

return true; 
return false; 
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步骤 5: 输出 找到 元 素 的 信息 。 


Console. WriteLine(" 开 始 时 间 晚 于 2018 年 7 月 15 日 的 工序 :"); 
Console. WriteLine( $ "编号 : {res. ID}\n 标题:{res. Title}\n 开始 时 间 :{res. StartTime}\n 结束 时 
间 :{res. EndTime}\n\n"); 


步骤 6: 查找 开始 时 间 晚 于 2018 年 7 月 10 日 的 工序 。 此 处 使 用 FindAll 方 法 , 它 会 把 
找到 的 所 有 元 素 组 成 新 的 数组 返回 。 


WorkItem[ ] resitems = Array.FindAll(itenms, i => 
{ 
DateTime condition = new DateTime(2018, 7, 10); 
if (i.StartTime > condition) 
return true; 
return false; 


D); 


步骤 7: 由 于 FindAll 方法 返回 的 是 数组 对 象 ,因此 在 获取 查找 结果 时 可 以 使 用 
foreach 循环 来 枚 举 元 素 。 


Console. WriteLine(" 开 始 时 间 晚 于 2018 年 7 月 10 日 的 工序 :"); 


foreach (var w in resitems) 


{ 


Console.WriteLine( $ "编号 :{w. ID}\n 标题 :{w. Title}\n 开始 时 间 :{w. StartTime} \n 结束 时 
间 :{w. EndTime}\n"); 
I 


步骤 8: 运行 应 用 程序 ,控制 台 的 输出 结果 如 图 6-11 所 示 。 


图 6-11 输出 查找 到 的 元 素 
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实例 175 ”查找 符合 条 件 的 元 素 的 索引 


【导语 】 

Find 与 FindAll 方法 是 直接 查找 元 素 并 将 其 返回 ,但 有 些 时 候 ,并 不 需要 知道 要 查找 的 
元 素 内 容 ,而 仅仅 需要 知道 其 所 在 位 置 ( 即 索 引 ) 。 

FindIndex 与 FindLastIndex 方法 支持 对 数组 中 的 元 素 进 行 查找 ,找到 后 返回 元 素 的 索 
引 。 两 个 方法 的 不 同 点 在 于 : FindIndex 方法 只 返回 符合 条 件 的 第 一 个 元 素 的 索引 ,而 
FindLastIndex 方法 则 返回 符合 条 件 的 最 后 一 个 元 素 的 索引 。 如 果 找 不 到 符合 条 件 的 元 素 ， 
这 两 个 方法 都 会 返回 一 1。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 字符 串 数 组 ,并 初始 化 。 


string[ ] src = 
{ 
"page”, 
"food", 
"make", 
"good", 
"sleep" 


}; 


步骤 3: 使 用 FindIndex 方法 查找 以 上 数组 中 含有 字母 a 的 元 素 , 并 返回 第 一 个 符合 条 
件 的 元 素 的 索引 。 


int index = Array.FindIndex(src, i => 
{ 
if (i.Contains("a")) 
return true; 
return false; 
]) 
Console. WriteLine(" 找 到 包含 字母 "a" 的 首 个 元 素 的 索引 :{0}"，index) ; 


步骤 4: 同样 ,查找 含有 字母 a 的 元 素 ,但 返回 符合 条 件 的 最 后 一 个 元 素 的 索引 。 


int lastindex = Array.FindLastIndex(src, i => 
{ 
if (i.Contains("a")) 
return true; 
return false; 
]) 
Console. WriteLine(" 找 到 包含 字母 "a" 的 最 后 一 个 元 素 的 索引 :{0}"，1lastindex); 


步骤 5: 运行 应 用 程序 ,输出 结果 如 图 6-12 所 示 。 
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图 6-12 ”查找 带 字母 a 的 元 素 索 引 


实例 176 ”确定 数组 中 元 素 的 存在 性 


【导语 】 

确定 元 素 的 存在 性 与 查找 元 素 不 同 , 因 为 不 需要 获得 元 素 的 相关 信息 ,只 需要 确定 数组 
中 是 否 包含 某 个 元 素 。 

判断 数组 中 是 否 存在 满足 条 件 的 元 素 , 可 以 调用 Exists 方法 ,如 果 存 在 符合 条 件 的 元 
素 ,该 方法 返回 true, 和 否则 返回 false。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 项 目 。 

步骤 2: 声明 一 个 Student 类 。 


public class Student 

{ 
public string Name { get; set; } 
public string City { get; set; } 
public string Course { get; set; } 

} 


步骤 3: 创建 一 个 Student 数组 ,并 填充 一 些 Student 对 象 。 


Student[ ] stus = 

new Student 

{ 
Name = "小 曹 "， 
Course = "C+t+", 
City =“" 广 州 " 

}, 

new Student 

{ 
Name = "小 王 "， 
Course = "PhotoShop", 
City = "成 都 

}, 

new Student 

{ 
Name = "小 刘 "， 
Course = "VB"， 
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City = "天 津 " 
} 
}; 
步骤 4: 调用 Exists 方法 确认 以 上 数组 中 是 否 存在 来 自重 庆 的 学 员 , 即 Student 对 象 的 
City 属性 是 否 为 “重庆 ”。 
bool res = Array.Exists(stus, x =>x.City == "重庆 "); 
if (res) 


Console. WriteLine(" 存 在 来 自重 庆 的 学 员 。"); 


else 
Console. WriteLine(" 不 存在 来 自重 庆 的 学 员 。"); 
上 述 数 组 实例 中 并 没有 City 属性 为 “重庆 ”的 Student 实例 ,因此 Exists 方法 返回 
false, 即 不 存在 符合 条 件 的 元 素 。 


实例 177 复制 数组 中 的 元 素 


本 实例 将 演示 如 何 将 一 个 数组 对 象 中 的 部 分 元 素 复 制 到 另 一 个 数组 对 象 中 ,其 中 用 到 
了 以 下 重 载 版 本 的 Copy 方法 (Array 类 公开 的 静态 方法 ) 。 
static void Copy (Array sourceArray, int sourceIndex， Array destinationArray, int 
destinationIndex, int length); 
sourceArray 表示 来 源 数组 ,方法 要 从 该 数组 中 复制 元 素 ; destinationArray 表示 目标 
数组 ,要 接收 被 复制 元 素 ; sourceIndex 是 来 源 数组 中 要 开始 进行 复制 的 元 素 索引 ， 
destinationIndex 是 目标 数组 中 要 开始 写 入 被 复制 元 素 的 索引 ; length 是 要 复制 元 素 的 
个 数 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 创建 一 个 int 数组 ,作为 来 源 数组 。 


int[] arrl = {1, 2, 3, 4, 5, 6}; 

步骤 3: 创建 第 二 个 数组 对 象 , 它 只 能 容纳 3 个 元 素 。 
int[] arr2 = new int[3]; 

步骤 4: 从 arrl 数组 中 复制 4、5、6 到 arr2 数组 中 。 
Array. Copy(arrl, 3, arr2, 0, 3); 


在 arrl 数组 中 ,元 素 4 的 索引 为 3, 因此 在 调用 Copy 方法 时 ,sourceIndex 参数 应 该 传 
递 数 型 值 3。 在 arr2 数组 中 ,从 第 一 个 索引 开始 存放 复制 过 来 的 元 素 , destinationIndex 参 
数 的 值 应 为 0。 

步骤 5: 分 别 输出 两 个 数组 中 的 元 素 进行 对 比 。 
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Console. WriteLine( $ "来 源 数组 :{string.Join('…' arr1)}"); 
Console. WriteLine( $ "目标 数组 :{string. Join(',', arr2)}"); 
步骤 6: 运行 应 用 程序 ,得 到 的 输出 结果 如 下 。 
来 源 数组 :1,2,3,4,5,6 


目标 数组 :4,5,6 

6.3 集合 
实例 178 ”将 数字 进行 降序 排列 
【导语 】 


标准 的 排序 方案 为 : 数字 从 小 到 大 ( 即 升序 ) ,字母 从 A 到 Z( 或 从 a 到 z) 。 如 果 要 让 数 
字 从 大 到 小 排序 ( 即 降序 ) ,可 以 尝试 用 比较 器 实现 。 

比较 器 可 以 分 析 两 个 对 象 之 间 的 差异 ,一 般 返 回 一 个 整数 值 ,如 果 该 值 等 于 0, 表 示 两 
个 对 象 相等 ; 如 果 该 值 大 于 0, 表 示 对 象 A 比 对 象 B 要 大 ; 如 果 该 值 小 于 0, 表 示 对 象 A 比 
对 象 B 要 小 。 

有 两 个 与 实现 自 定义 比较 相关 的 接口 : IComparer 接口 面向 Object 类 型 ; IComparer< 工 > 
接口 带 类 型 参数 ,可 以 更 好 地 控制 要 进行 比较 的 类 型 。 

不 过 ,在 实战 阶段 ,开发 者 可 以 不 直接 实现 以 上 两 个 接口 ,而 是 考虑 从 Comparer< 工 > 
类 派生 。Comparer < > 是 抽象 类 ,派生 时 必须 实现 Compare 方法 ,原型 如 下 。 


int Compare(T x, TY) 


类 型 T 是 个 类 型 参数 ,可 用 实际 类 型 替换 。 

通过 访问 Default 静态 属性 ,也 可 以 获得 标准 (默认 ) 的 比较 器 。 当 数值 A 大 于 数值 B 
时 ,返回 大 于 0 的 整数 ; 当 数 值 A 小 于 数值 B 时 ,返回 小 于 0 的 整数 ,该 方法 默认 以 升序 排 
列 。 所 以 要 想 实 现 降序 排列 ,只 要 反 过 来 即 可 : 当 数 值 A 大 于 数值 B 时 ,返回 小 于 0 的 整 
数 ; 当 数 值 A 小 于 数值 B 时 ,返回 大 于 0 的 整数 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 从 Comparer< 工 > 派生 出 一 个 自 定义 的 比较 器 ,因为 本 实例 是 针对 int 类 型 数 
值 进行 处 理 ,T 的 类 型 为 int。 

public class MyComparer : Comparer < int> 

E public override int Compare( int x, int y) 

{ 


return 一 (x — y); 


} 


210 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


Compare 方法 的 实现 很 简单 ,直接 将 两 个 数值 相 减 ,然后 在 前 面 加 上 一 个 负 号 (一 ) 即 
可 。 加 上 负 号 之 后 ,本 来 大 于 0 的 值 就 会 变 成 小 于 0, 本 来 小 于 0 的 值 就 会 大 于 0, 这 就 达到 
反 向 排序 的 效果 了 。 

步骤 3: 此 处 使 用 SortedSet < T > 集合 来 做 演示 ,只 要 往 这 个 类 里 面 添加 元 素 就 会 自动 
排序 ,不 需要 去 调用 Sort 方法 。 在 初始 化 时 ,需要 将 上 述 自 定义 的 MyComparer 比较 器 实 
例 传递 给 构造 函数 ,否则 它 只 会 按 默 认 规 则 排序 。 


SortedSet < int > list = new SortedSet < int >(new MyComparer()); 
步骤 4: 向 集合 添加 5 个 整数 值 。 


list. Add(15); 
list. Add(2); 
list. Add(25); 
list. Add(13); 
list. Add(7); 


步骤 5: 为 了 验证 是 否 自 动 进行 降序 排列 ,可 以 将 集合 中 的 元 素 输 出 到 控制 台 。 


foreach (int x in list) 
{ 
Console. WriteLine(x); 


’ 
步骤 6: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 


实例 179 初始 化 List<T> 集 合 


【导语 】 

List < 全 > 类 是 泛 型 类 , 带 有 类 型 参数 ,所 以 它 表示 的 是 一 种 强 类 型 的 集合 ,并 且 支 持 动 
态 添加 、 删除、 修改 ,查找 元 素 等 操作 。 

在 实例 化 List < 了 > 对 象 时 ,可 以 创建 一 个 空 的 列表 ,然后 往 里 面 添 加 元 素 , 例 如 调用 
Add 或 AddRange 方法。 每 次 调用 Add 方法 只 能 添加 一 个 元 素 ,而 调用 AddRange 方法 可 
以 一 次 性 添加 多 个 元 素 , 也 可 以 将 其 他 集合 (例如 数组 ) 的 元 素 加 进去 。 

也 可 以 把 另 一 个 集合 实例 (实现 了 IEnumerable < out T > 接口 的 均 可 ) 传 递 给 
List < 全 > 的 构造 函数 来 初始 化 ,调用 构造 函数 后 会 自动 将 另 一 个 集合 的 元 素 添加 到 当前 列 
表 中 。 
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【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 System. Collections. Generic 命名 空间 ,许多 泛 型 集合 相关 的 类 型 都 在 这 
个 命名 空间 下 。 

using System. Collections. Generic; 

步骤 3: 实例 化 一 个 空白 的 列表 。 

List< int> la = new List< int >(); 

步骤 4: 调用 3 次 Add 方 法 ,添加 3 个 元 素 。 


la. Add(5); 
la. Add(6); 
la. Add(7); 


步骤 5: 调用 AddRange 方法 ,把 一 个 数组 实例 中 的 3 个 元 素 也 添加 进 当 前 列表 中 。 


int[] a = { 29, 39, 49 }; 
la. AddRange(a); 


步骤 6: 输出 la 列表 中 所 有 元 素 。 此 时 la 列表 中 应 有 6 个 元 素 。 


Console. WriteLine(" 第 一 个 列表 中 的 元 素 :"); 
foreach (int n in la) 


{ 


Console. Write(" {0}", n); 
步骤 7: 实例 化 第 二 个 列表 ,并 且 把 上 述 la 列表 实例 传递 给 构造 函数 , 即 lb 列表 初始 化 
后 就 带 有 6 个 元 素 了 。 
List< int> lb = new List< int>(1a); 
步骤 8: 再 向 lb 列表 中 添加 2 个 元 素 。 


1b. Add(100); 
1b. Add( 600); 


步骤 9: 输出 lb 列表 中 的 元 素 。 此 时 lb 列表 中 应 有 8 个 元 素 。 
Console. WriteLine("\n\n 第 二 个 列表 中 的 元 素 :"); 


foreach (int n in 1b) 
{ 
Console. Write(" {0}", n); 


有 
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步骤 10: 运行 应 用 程序 ,输出 结果 如 图 6-13 所 示 。 


图 6-13 输出 la 和 lb 列表 的 元 素 


实例 180 ”实现 IEnumerator 接口 


【导语 】 

IEnumerator 接口 位 于 System. Collections 命名 空间 下 , 它 的 作用 是 对 集合 元 素 进 行 枚 
举 。 在 实现 该 接口 时 ,主要 实现 以 下 两 个 成 员 : 

(1) Current 属性 : 获取 当前 位 置 的 元 素 。IEnumerator 在 枚 举 集 合 元 素 时 只 会 一 路 向 
前 ,从 第 一 个 元 素 到 最 后 一 个 元 素 ,逐个 列举 ,并 且 是 只 读 的 。 也 就 是 说 ,在 枚 举 元 素 的 过 程 
中 ,不 能 对 集合 进行 修改 (不 能 添加 、 删 除 或 替换 元 素 )。 

(2) MoveNext 方法 : 这 个 方法 是 完成 枚 举 逻 辑 的 核心 ,必须 实现 。 在 IEnumerator 初 
始 化 时 ,必须 将 当前 位 置 放 到 所 有 元 素 之 前 (如 果 要 枚 举 集合 对 象 ,可 以 将 索引 定位 为 一 1)， 
Current 属性 也 要 初始 化 为 默认 值 ,例如 null( 引 用 类 型 ) 或 者 0( 值 类 型 )。 当 调用 
MoveNext 方法 时 , 枚 举 器 向 前 位 移 一 个 位 置 ,并 把 下 一 个 元 素 赋 值 给 Current 属性 。 成 功 
枚 举 元 素 后 返回 true, 如 果 已 经 到 了 集合 的 末尾 或 者 无 法 再 往 下 枚 举 , 需 要 返回 false。 

还 有 一 个 Reset 方法 ,此 方法 只 用 于 COM 互 操 作 。 如 果 代码 中 不 使 用 COM 互 操作 ， 
此 方法 可 以 保留 空白 (不 添加 任何 实现 代码 ) 。 

从 IEnumerator 接口 还 引申 出 一 个 IEnumerator<T > 接口 ,声明 如 下 : 


public interface IEnumerator < out T> : IEnumerator，IDisposable 


它 是 一 个 泛 型 接口 , 带 有 输出 参数 T( 协 变 ) ,并 继承 了 IEnumerator 接口 的 成 员 , 同 时 包含 
IDisposable 接口 的 成 员 。IDisposable 接口 有 一 个 Dispose 方 法 ,实现 它 可 以 在 对 象 实例 被 
销毁 时 释放 相关 的 资源 (例如 对 文件 句柄 的 引用 ) 。 

IEnumerator< 工 > 接口 也 存在 一 个 与 IEnumerator 接口 同名 的 属性 一 一 Current, 但 它 
的 类 型 不 是 Object, 而 是 由 类 型 参数 工 指 定 的 类 型 。 因 此 当 实 现 IEnumerator < 本 > 接口 
时 ,可 以 先 实现 该 接口 的 Current 属性 ,然后 显 式 实现 IEnumerator 接口 的 Current 属性 ,这 
样 可 以 避免 同名 成 员 的 冲突 。 

本 实例 将 演示 一 个 实现 IEnumerator < 了 > 接口 的 自 定义 类 , 它 将 枚 举 出 10 个 随机 生 
成 的 整数 。 当 已 产生 的 整数 超过 10 个 时 ,MoveNext 方法 返回 false。 

【操作 流程 】 

步骤 1: 在 Visual Studio 中 创建 一 个 控制 台 应 用 程序 项 目 。 


第 6 章 


步骤 2: 引入 以 下 两 个 命名 空间 。 


using System. Collections; 


using System. Collections. Generic; 


步骤 3: 声明 一 个 实现 了 IEnumerator<T > 的 类 ,其 中 用 int 替换 类 型 T。 详 见 代码 清 


单 6-3。 


代码 清单 6-3 MyEnumerator 类 的 完整 代码 


public class MYEnumerator : IEnumerator < int > 


Random rand = null; 
int count; 


public MyEnumerator() 


{ 
rand = new Random(); 
count = 0; 
Current = default(int); 
} 


public int Current { get; private set; } 


object IEnumerator. Current 
{ 
get { return Current; } 


} 


public void Dispose() 
{ 
rand = null; 


} 


public bool MoveNext() 
{ 
if (++count > 10) 
return false; 
Current = rand. Next(); 
return true; 


} 


public void Reset() 
{ 
count = 0; 
Current = default(int); 


泛 型 
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在 MyEnumerator 类 的 构造 函数 中 ,对 相关 成 员 进 行 初始 化 。rand 字段 引用 了 
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Random 类 实例 ,负责 产生 随机 整数 ,该 实例 可 在 Dispose 方法 中 销毁 引用 ( 即 给 变量 赋值 
null 引用 ) ,也 可 以 不 处 理 ,运行 时 会 自行 清理 。count 字段 用 来 存放 已 经 枚 举 的 整数 数量 ， 
初始 化 时 为 0, 每 产生 一 个 整数 值 就 会 加 上 1 。 

在 MoveNext 方法 中 , 先 将 count 字段 加 上 1, 如 果 加 1 后 大 于 10, 直 接 返回 false, 不 需 
要 枚 举 项 目 了 ; 否则 产生 新 的 随机 数 , 并 赋值 给 Current 属性 ,最 后 返回 true。 

Reset 方法 不 是 必需 的 ,可 以 保留 但 不 编写 实现 代码 , 它 主要 用 于 COM 交互 ,此 处 将 
count 字段 与 Current 属性 的 值 还 原 为 默认 值 。 

步骤 4: 在 Main 方法 中 ,实例 化 MyEnumerator 类 。 


MyEnumerator et = new MyEnumerator(); 
步骤 5: 通过 循环 调用 MoveNext 方法 枚 举 出 所 有 随机 产生 
的 整数 ,直到 它 返回 false。 


while (et.MoveNext()) 


{ 


Console, WriteLine(et. Current); 


} 图 6-14 枚 举 出 的 

步骤 6: 运行 应 用 程序 ,上 述 代 码 所 枚 举 的 10 个 随机 整数 如 10 个 整数 
图 6-14 所 示 。 

实例 181 IEnumerable 接口 与 foreach 循环 

【导语 】 


若 某 个 集合 类 型 实现 了 IEnumerable 接口 ,就 可 以 使 用 foreach 循环 语句 对 其 进行 枚 
举 。IEnumerable 接口 只 有 一 个 方法 一 一 GetEnumerator, 该 方法 被 调用 后 会 向 调用 方 返 回 
一 个 实现 了 IEnumerator 接口 的 类 型 实例 ,然后 程序 代码 就 可 以 通过 MoveNext 方法 ,并 本 
合 使 用 Current 属性 来 逐一 获取 集合 中 的 元 素 。 

常用 的 集合 类 型 如 SortedList、Hashtable、Queue 等 都 实现 了 IEnumerable 接口 ,因此 
可 以 直接 使 用 foreach 循环 枚 举 其 中 的 元 素 。 

本 实例 将 演示 一 个 自 定义 类 ,该 类 实现 了 IEnumerable 接口 ,并且 该 类 中 包含 一 个 
string 类 型 的 数组 。GetEnumerator 方法 返回 用 于 枚 举 string 数组 的 对 象 实例 ,该 实例 的 
类 型 实现 了 IEnumerator 接口 ,可 以 通过 它 的 MoveNext 方法 向 前 移动 要 访问 的 索引 位 置 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 首先 声明 一 个 实现 了 IEnumerator 接口 的 类 , 它 的 功能 是 配合 MoveNext 方法 
与 Current 属性 来 枚 举 string 数组 中 的 元 素 。 为 了 能 访问 到 相关 数组 ,该 类 的 构造 函数 带 
有 一 个 接收 string 数组 类 型 的 参数 。 详 见 代码 清单 6-4。 
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代码 清单 6-4 MyEnumerator 类 的 完整 代码 


internal class MYEnumerator : IEnumerator 


{ 
string[ ] _arr; 


int currentIndex; 


public MyEnumerator( string[ ] src) 
1 


arr = src; 


_currentIndex = —1; 


} 
public object Current { get; private set; } 


public bool MoveNext() 
{ 
// 如 果 当 前 位 置 已 超出 索引 的 最 大 值 ,就 返回 false 
if(++_currentIndex >= _arr. Length) 
{ 
Current = null; 
return false; 


} 


Current = _arr[_currentIndex]; 
return true; 


} 


public void Reset() 


{ 
throw new NotImplementedException( ); 


} 


注意 : IEnumerator 只 能 向 前 读 取 , 不 能 循环 读 取 。 也 就 是 说 , 当 要 读 取 元 素 的 索引 已 经 超 
出 数组 的 大 小 后 ,必须 使 MoveNext 方法 返回 false, 不 能 重新 回 到 集合 的 开始 位 置 。 
Reset 方法 可 以 不 添加 实现 代码 。 


步骤 3: 声明 一 个 模拟 集合 类 ,实现 IEnumerable 方法 。 


public class MyExampleCollection : IEnumerable 
{ 


string[ ] arraySrc = { "red", "blue", "green", "gray" }; 


public IEnumerator GetEnumerator() 
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{ 
return new MyEnumerator(arraySrc); 
} 
} 
GetEnumerator 方法 将 返回 刚才 声明 的 MyEnumerator 类 实例 。 
步骤 4: 回 到 Main 方法 , 先 创建 一 个 新 的 MyExampleCollection 实例 。 


MyExampleCollection en = new MyExampleCollection(); 


步骤 5: 此 时 可 以 使 用 foreach 循环 语句 直接 对 
MyExampleCollection 实例 进行 枚 举 。 


foreach(var item in en) 


{ 


Console. WriteLine( item); 


: 


步骤 6: 运行 应 用 程序 项 目 ,输出 的 结果 如 图 6-15 
所 示 。 


实例 182”IEnumerable < 本 > 与 foreach 循环 


【导语 】 

IEnumerable 接口 只 能 针对 Object 类 型 进行 处 理 , 在 使 用 foreach 循环 时 也 是 默认 以 
Object 类 型 访问 。 因 此 在 枚 举 集合 元 素 时 常常 要 进行 类 型 转换 ,而 这 些 类 型 转换 多 数 情况 
下 是 不 必要 的 ,频繁 进行 类 型 转换 对 应 用 程序 的 性 能 也 有 负面 影响 。 

为 了 解决 以 上 问题 , 便 衍 生出 IEnumerable < 本 > 接口 ,声明 如 下 。 


图 6-15 ”循环 列 出 四 个 字符 串 实例 


interface IEnumerable < out T> : IEnumerable 


从 接口 的 声明 可 以 看 出 , 它 也 包含 了 IEnumerable 接口 的 成 员 。IEnumerable< 工 > 接 
口 还 重新 定义 了 GetEnumerator 方法 .使 其 所 返回 的 对 象 也 支持 泛 型 。 


IEnumerator <T> GetEnumerator( ); 


有 了 类 型 参数 全 ,就 可 以 限制 集合 的 类 型 ,而 不 再 是 默认 的 Object, 可 以 在 一 定 程度 上 
避免 了 过 多 的 类 型 转换 。 在 使 用 foreach 循环 语句 枚 举 元 素 时 也 可 以 做 到 强 类 型 。 

本 实例 以 decimal 类 型 替换 类 型 参数 ,实现 IEnumerable<T 工 > 接口 。 当 用 foreach 语 
句 枚 举 元 素 时 ,临时 变量 可 以 直接 表示 为 decimal 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 为 了 方便 调用 , 先 实 现 IEnumerator < 本 > 接口 .TT 为 decimal。 详 见 代码 清单 6-5。 
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代码 清单 6-5 NumberEnumerator 类 的 完整 代码 


internal class NumberEnumerator : IEnumerator < decimal > 
{ 
decimal[ ] srcNumbers; // 来 源 数 组 
int currentIndex; // 当 前 元 素 的 索引 


public NumberEnumerator(decimal[ ] source) 
{ 


srcNumbers = source; 
currentIndex = —1; // 索 引 位 于 第 一 个 元 素 之 前 


public decimal Current { get; private set; } 


// 显 式 实现 IEnumerator 接口 的 Current 属性 


object IEnumerator. Current => Current; 


public void Dispose() 
{ 


} 


public bool MoveNext() 
{ 
// 如 果 索 引 超出 范围 
if(++currentIndex > = srcNumbers. Length) 
{ 
Current = default; 
return false; 
} 
// 获取 当前 索引 处 的 元 素 
Current = srcNumbers[currentIndex]; 
return true; 


} 


public void Reset() 
{ 


} 
} 


此 处 Reset 和 Dispose 方法 可 以 保留 空白 方法 体 。 
步骤 3: 实现 IEnumerable< 工 >,T 为 decimal。 


public class Numbers : IEnumerable< decimal > 
{ 
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decimal[ ] numberarr = { 7.33M, 16.12M, 800.56M, 1202.633M, 170.9M }; 


public IEnumerator < decimal > GetEnumerator( ) 
! 
return new NumberEnumerator (numberarr); 


} 


// 显 式 实现 IEnumerable 接口 的 GetEnumerator 方法 
IEnumerator IEnumerable. GetEnumerator() 
{ 


return GetEnumerator( ); 
} 
}: 


步骤 4: 回 到 Main 方法 ,创建 Numbers 实例 。 
Numbers nbs = new Numbers(); 


步骤 5: 使 用 foreach 语句 枚 举 元 素 ,临时 变量 可 以 直接 声明 
为 decimal 类 型 。 


foreach (decimal n in nbs) 


{ 


图 6-16 foreach 循环 枚 
Console. WriteLine(" {0:6}", n); 举 出 来 的 数值 


了 
步骤 6: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 6-16 所 示 。 


实例 183 IEnumerable 接口 与 yield return 语句 


【导语 】 

yield return 语句 比较 有 趣 , 它 可 以 在 一 个 方法 (get 访问 器 或 运算 符 ) 中 返回 多 个 值 (每 
条 yield return 语句 返回 一 个 值 ,但 可 以 多 次 使 用 ) ,这 些 返回 值 会 被 隐 式 地 组 成 一 个 集合 实 
例 ( 迭 代 器 ) 。 因 此 ,包含 yield return 语句 的 成 员 , 其 返回 类 型 必须 是 IEnumerable 或 者 是 
IEnumerable< 工 >。 

无 须 显 式 地 编写 新 类 来 实现 IEnumerable 或 者 是 IEnumerable< T > 接口 ,仅仅 将 接口 
类 型 作为 返回 类 型 即 可 ,运行 时 会 隐 式 创建 集合 。 如 果 返 回 的 类 型 是 IEnumerable 接口 ,那么 
使 用 foreach 语句 枚 举 出 来 的 元 素 默 认为 object 类 型 。 如 果 返 回 的 类 型 是 IEnumerable< 工 > 
接口 ,那么 foreach 语句 枚 举 出 来 的 类 型 就 是 类 型 参数 T 的 具体 类 型 。 例 如 ,返回 类 型 为 
IEnumerable< int >, 那 么 在 使 用 foreach 语句 时 , 枚 举 出 来 的 元 素 为 int 类 型 。 

代码 逻辑 在 使 用 foreach 循环 进行 迭代 时 ,会 将 每 一 条 yield return 语句 后 的 元 素 依次 
返回 ,其 间 如 果 想 终止 迭代 ,可 以 使 用 如 下 yield break 语句 。 


yield break; 
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【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模 板 生 成 的 Program 类 中 定义 一 个 静态 方法 ,返回 类 型 为 
IEnumerable ,在 方法 体 中 ,依次 返回 3 个 int 数值 。 


static IEnumerable Test1() 
{ 

yield return 0; 

Yield return 1; 

Yield return 2; 


} 
步骤 3: 再 在 Program 类 中 定义 一 个 静态 方法 ,此 次 返回 类 型 为 IEnumerable < string >， 
方法 依次 返回 3 个 字符 串 实例 。 


static IEnumerable< string> Test2() 
{ 

Yield return "abcd"; 

Yield return "opqrs"; 

Yield return "@# $% "; 
} 


步骤 4: 在 Main 方法 中 , 先 调用 Testl 方法 ,并 与 foreach 循环 一 起 使 用 , 枚 举 其 返回 
的 内 容 。 


foreach (var item in Test1()) 


{ 
Console. WriteLine( item); 


} 
步骤 5: 用 同样 的 方式 调用 Test2 方法 。 


foreach (var item in Test2()) 
{ 


Console. WriteLine( item); 
} 
以 上 两 个 foreach 循环 中 ,都 用 var 关键 字 来 声明 临时 变量 item, 目 的 是 让 编译 器 自动 
推断 类 型 。 
如 图 6-17 所 示 ,把 鼠标 指针 移 到 枚 举 Testl 方法 返回 结果 的 item 变量 上 ,从 智能 提示 
可 以 看 到 ,item 变量 被 推断 为 object 类 型 。 


item Test1()) 


nna 


>. WriteLine (item); 


图 6-17 智能 提示 显示 为 object 类 型 
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在 枚 举 Test2 方法 返回 结果 的 代码 中 ,item 变量 被 推断 为 string 类 型 ,如 图 6-18 所 示 。 


item Test20) 


口 sea 


le. WriteLine(item) ; 


图 6-18 智能 提示 显示 为 string 类 型 


实例 184 ”无 重复 元 素 的 集合 


【导语 】 
HashSet < 本 > 是 一 个 泛 型 集合 ,与 其 他 集合 类 相 比 , 它 有 一 个 明显 的 特征 一 一 该 集合 


不 能 包含 重复 的 元 素 。 当 调用 Add 方法 向 集合 中 添加 元 素 后 会 返回 一 个 布尔 值 ,如 果 成 功 
添加 就 返回 true; 如 果 在 集合 中 已 经 存在 要 添加 的 元 素 ,Add 方法 会 返回 false, 并 且 元 素 不 
会 被 添加 到 集合 中 。 


十 


; 当 再 次 添加 1000 时 ,由 于 元 素 已 经 存在 ,所 以 第 二 次 的 1000 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 一 个 HashSet < 本 > 实例 ,类 型 下 为 int 类 型 。 

HashSet < int > set = new HashSet < int >(); 

步骤 3: 调用 3 次 Add 方法 向 集合 中 添加 元 素 ,并 对 方法 的 返回 值 进行 分 析 。 


// 不 重复 ,可 添加 
bool b = set.Add(1000); 
Console. WriteLine(" 元 素 {0} {1}。"，1000，b ? "添加 成 功 ” : "未 添加 ")， 


// 不 重复 ,可 添加 
b = set.Add(2000); 
Console. WriteLine(" 元 素 {0} {1}"，2000, b ? "添加 成 功 ”: "未 添加 "); 


// 1000 已 经 存在 ,不 添加 
b = set.Add(1000); 
Console. WriteLine(" 元 素 {0} {1}"，1000,b ? "添加 成 功 ”: "未 添加 "); 


因为 1000 与 2000 两 个 元 素 不 重复 ,所 以 能 成 功 添加 到 集合 


不 会 被 添加 。 


步骤 4: 运行 应 用 程序 ,输出 结果 如 图 6-19 所 示 。 图 世态 林 存 惠 丰 及 
有 重复 元 素 
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实例 185 ”双向 链表 


【导语 】 

LinkedList< T > 是 一 个 比较 有 趣 的 集合 , 它 属 于 “双向 ”链表 ,支持 如 下 操作 。 

(1) 在 列表 首部 插入 元 素 。 

(2) 在 列表 尾部 插入 元 素 。 

(3) 在 某 个 元 素 之 前 插入 元 素 。 

(4) 在 某 个 元 素 之 后 插入 元 素 。 

(5) 元 素 可 以 从 列表 中 移 除 ,也 可 以 重新 加 入 到 列表 的 任意 位 置 。 

LinkedList< 了 > 是 泛 型 集合 ,可 用 实际 类 型 替换 类 型 参数 T。 加 入 到 列表 中 的 元 素 都 
LinkedListNode< 工 > 对 象 进行 维护 , 称 为 结 点 。 当 元 素 被 移 除 之 前 ,可 以 通过 结 点 的 
Previous 属性 获得 当前 元 素 的 前 一 个 结 点 ,或 通过 Next 属性 获取 下 一 个 结 点 。 

每 个 LinkedListrNode < 全 > 实例 也 是 可 单独 维护 的 , 结 点 从 一 个 列表 中 移 除 并 添加 到 
另 一 个 列表 的 过 程 中 ,不 会 分 配 新 的 内 存 空 间 。 访 问 Value 属性 可 以 获取 到 与 结 点 对 应 的 
元 素 值 。 

运用 LinkedList < 本 > 集合 类 ,可 以 对 元 素 进行 任意 顺序 “组 装 ”。 本 实例 将 演示 两 个 
LinkedList < 全 > 集合 的 常规 用 法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 第 一 个 LinkedList 集合 。 


LinkedList < string> list = new LinkedList < string>(); 
步骤 3: 向 集合 中 添加 5 个 元 素 。 


// 添加 第 一 个 

var node = list.AddFirst(" 秦 "); 
// 跟随 其 后 

node = list.AddAfter(node, " 汉 "); 
// 同上 

node = list.AddAfter(node, " 隋 "); 
// 跟随 其 后 , 先 添加 " 宋 " 

node = list.Rhddafter(node，" 宋 "); 
// 再 在 " 宋 " 之 前 插入 " 唐 " 

list. AddBefore(node," 唐 "); 


添加 元 素 后 ,方法 会 返回 一 个 LinkedListNode < 了 > 实例 ,以 便 调 整 顺 序 。 
步骤 4: 创建 第 二 个 LinkedList 实例 。 


LinkedList <byte> list2 = new LinkedList < byte>(); 


步骤 5: 在 列表 的 尾部 连续 追加 4 个 元 素 。 
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list2. AddLast (1); 
list2. AddLast (3); 
list2. AddLast (2); 
list2. AddLast(4); 


步骤 6: 此 时 ,集合 中 元 素 的 顺序 为 1、3、2、4, 接 下 来 把 3 和 2 调换 一 下 ,让 顺序 变 为 1、 
2.3、4。 


// 先 找 出 元 素 3 

var foundnode = list2.Find(3); 

// 获取 元 素 2 的 结 点 

var thirdnode = foundnode. Next; 

// 将 该 元 素 移 除 

list2. Removel( foundnode); 

// 再 把 这 个 元 素 插入 到 2 之 后 

list2. AddAfter(thirdnode, foundnode. Value); 


调整 方法 是 : 先 找 出 3 所 在 的 结 点 ,再 通过 这 个 结 点 找 
到 2 所 在 的 结 点 (因为 两 个 结 点 是 连续 的 ,所 以 可 以 通过 
Next 属性 获取 ) 。 接 着 将 3 移 除 , 最 后 再 插入 到 2 的 后 面 。 


a 和 图 6-20 ”两 个 LinkedList 
步骤 7: 运行 应 用 程序 ,控制 台 输出 的 结果 如 图 6-20 集合 中 的 元 素 


所 示 。 


实例 186” 自 定义 相等 比较 


【导语 】 

要 判断 两 个 对 象 是 否 相 等 ,框架 默认 的 比较 方式 有 时 并 不 能 满足 实际 开发 需求 ,尤其 是 
在 使 用 字典 等 数据 结构 的 场合 。 这 时 候 , 开 发 人 员 应 当 考虑 实现 所 需要 的 相等 比较 方式 。 

编写 自 定义 的 相等 比较 逻辑 ,有 以 下 几 个 可 选 方案 。 

(1) 重 写 Object 类 的 Equals 方法 。 由 于 Equals 是 在 Object 类 中 定义 的 虚 方 法 ,并 且 
所 有 类 型 都 以 Object 为 基 类 ,因此 在 自 定义 的 类 型 中 ,可 以 通过 重 写 Equals 方法 来 安排 比 
较 逻 辑 。 

(2) 实现 IEqualityComparer 接口 。 该 接口 除了 有 Equals 方法 外 ,还 需要 实现 
GetHashCode 方法 。GetHashCode 方法 返回 一 个 int 值 , 用 于 唯一 标识 该 对 象 , 即 为 对 象 设 
置 一 个 索引 。 返 回 哈 希 码 可 以 提升 两 个 对 象 在 相等 比较 中 的 处 理 效率 ,如 果 两 个 对 象 返 回 
相同 的 哈 希 码 ,就 可 以 认为 两 者 是 相等 的 ,这 样 就 省 去 了 深度 比较 所 花费 的 性 能 开销 。 当 哈 
希 码 无 法 为 对 象 进行 唯一 标识 时 ,就 会 调用 Equals 方法 进行 更 深层 次 的 比较 。 

(3) 实现 IEqualityComparer < 了 > 接口 。IEqualityComparer 接口 是 针对 object 类 型 
的 ,对 类 型 的 约束 不 强 , 而 且 比较 过 程 中 会 进行 大 量 的 类 型 转换 (频繁 装 箱 与 拆 箱 ) ,造成 一 
定 的 性 能 损失 。IEqualityComparer<T> 属 于 泛 型 接口 ,可 通过 类 型 参数 T 对 比较 对 象 的 
类 型 进行 约束 ,提升 比较 运算 的 效率 。 
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(4) 实现 EqualityComparer < T > 抽象 类 。 此 类 实现 了 IEqualityComparer 与 
IEqualityComparer< T > 两 个 接口 (对 IEqualityComparer 接口 采取 了 显 式 实现 方案 ) ,并且 
包括 框架 的 默认 比较 方案 (通过 静态 的 Default 属性 可 以 获取 ) 。 

在 现实 开发 过 程 中 ,笔者 比较 推荐 实现 EqualityComparer < 本 > 抽象 类 的 方案 ,因为 此 
方案 既 有 框架 内 部 的 默认 实现 ,又 包含 自 定义 的 实现 ,可 用 性 更 强 。 

本 实例 将 演示 如 何 实现 EqualityComparer<T > 抽象 类 ,并 通过 HashSet < T > 集合 进 
行 测试 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 Contact 类 ,模拟 联系 人 信息 (包括 身份 标识 、 姓 名、 手机 号 三 个 属性 )。 


public class Contact 

{ 
public string Name { get; set; } 
public string PhoneNo { get; set; } 
public long ID { get; set; } 

} 


步骤 3: 实现 EqualityComparer < 下 > 抽象 类 ,实现 两 个 Contact 对 象 的 相等 比较 ,T 参 
数 的 类 型 为 Contact。 


public sealed class ContactEqualityComparer : EqualityComparer < Contact > 
* 
public override bool Equals(Contact x, Contact y) 
{ 
if (x == null || y == null) 
return false; 
if (object. ReferenceEquals(x, y)) 
return true; 
if (x.ID == Y.ID && x.Name == Y.Name && x.PhoneNo == Y.PhoneNo) 
return true; 
return false; 


public override int GetHashCode(Contact obj) 


return obj. ID. GetHashCode( ) ^ obj. Name. GetHashCode( ) ^ obj. PhoneNo. GetHashCode( ); 


} 

GetHashCode 方法 的 最 优 实现 方案 是 : 既 能 得 到 对 象 的 唯一 标识 ,又 能 尽 可 能 地 简单 
以 保证 运算 效率 。 一 般 来 说 ,将 类 型 中 各 个 属性 (或 字段 ) 的 值 的 哈 希 码 进行 “ 异 或 ?运算 ,这 
种 运算 法 则 被 称 为 * 同 为 0. 异 为 1”。 
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在 实现 Equals 方法 时 ,进行 了 以 下 三 个 层次 的 比较 : @ 如 果 两 个 Contact 对 象 中 有 其 
中 一 个 为 null, 则 无 须 再 深入 分 析 , 二 者 必然 不 相等 ; @ 引 用 比较 ,如 果 两 者 指向 的 是 同一 
个 对 象 实例 ,必然 是 相等 的 ; @ 如 果 以 上 两 个 层次 均 无 法 判定 ,就 对 Contact 对 象 的 三 个 属 
性 值 进行 一 一 比较 。 

步骤 4: 由 于 HashSet<T > 集合 中 不 存放 重复 的 元 素 ,因此 使 用 该 集合 进行 相等 比较 
测试 的 效果 明显 。 实 例 化 一 个 HashSet 集合 ,并 将 刚才 定义 的 ContactEqualityComparer 
实例 传递 给 构造 函数 ,这 样 就 可 以 覆盖 HashSet 集合 中 元 素 的 默认 比较 方案 。 


HashSet < Contact > set = new HashSet < Contact >(new ContactEqualityComparer()); 
步骤 5: 在 集合 中 执行 五 次 添加 元 素 操作 。 详 见 代 码 清单 6-6 。 
代码 清单 6-6 ”执行 五 次 添加 元 素 操作 


set. Add( new Contact 


ID = 721001, 

Name = " 老 李 "， 

PhoneNo = "223225688" 
); // 第 一 次 添加 


// 添加 相同 实例 


Contact cl = new Contact 


ID = 7412002, 
Name = " 老 何 "， 
PhoneNo = "1685584562" 


Caaeaie c2 = cl; 
set. Add(c1); // 第 二 次 添加 
set. Add(c2); // 第 三 次 添加 


// 不 同 实例 ,但 属性 值 相同 


Contact c3 = new Contact 


ID = 500002, 
Name = " 老 肖 "， 
PhoneNo = "170023" 
区 
Contact c4 = new Contact 


ID = 500002, 
Name = " 老 肖 "， 
PhoneNo = "170023" 


set. Add(c3); // 第 四 次 添加 
set. Add(c4); // 第 五 次 添加 
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步骤 6: 输出 集合 中 所 有 元 素 。 


foreach (Contact c in set) 


string msg = $ "身份 标识 :{c. ID}\n" + 
$ "姓名 :{c. Name}\n" + 
$ "手机 :{c.PhoneNo}\n"; 
Console. WriteLine(msg); 
} 
虽然 添加 了 五 次 元 素 ,但 集合 中 仅 有 3 个 元 素 , 原 因 是 : 第 


-次 添加 的 是 一 个 全 新 的 Contact 对 象 ,这 是 一 个 元 素 ; 第 二 次 
和 第 三 次 添加 的 元 素 都 引用 了 同一 个 对 象 实例 ,只 能 算 一 个 元 
素 ; 第 四 次 和 第 五 次 添加 的 元 素 虽 然 不 是 同一 个 实例 ,但 它们 的 
各 自 对 应 的 属性 值 相同 , 视 为 相等 ,也 只 能 算 一 个 元 素 , 总 共 为 3 
不 元 本 :5 

步骤 7: 运行 应 用 程序 ,输出 结果 如 图 6-21 所 示 。 


实例 187 ”清空 集合 中 的 所 有 元 素 


【导语 】 

许多 集合 都 公开 了 Clear 方法 ,可 以 一 次 性 删除 集合 中 的 所 有 元 素 。Remove 方法 通常 
只 能 删除 一 个 元 素 ,虽然 可 以 通过 循环 语句 调用 Remove 方法 来 删除 集合 中 的 所 有 元 素 ,但 
也 不 如 一 次 性 调用 Clear 方法 简练 ,余下 的 删除 操作 就 在 运行 时 由 框架 处 理 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


图 6-21 仅 输 出 3 个 元 素 


using System. Collections. Generic; 
步骤 3: 创建 List < 本 > 实例 ,并 添加 一 些 元 素 。 


List< int> list = new List< int>(); 
list. Add(25); 
list. Add(26); 
list. Add(27); 


步骤 4: 在 调用 Clear 方法 前 后 ,分 别 输出 列表 中 元 素 的 个 数 ,以 便 观察 效果 。 


Console. WriteLine(" 列 表 中 元 素 个 数 :{0}"，1ist. Count); 
list. Clear(); 
Console. WriteLine(" 调 用 Clear 方法 后 ,列表 中 的 元 素 个 数 :{0}"，list. Count); 
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步骤 5: 按 F5 快捷 键 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 


列表 中 元 素 个 数 :3 
调用 Clear 方法 后 ,列表 中 的 元 素 个 数 :0 


实例 188 ”判断 字典 集合 中 是 否 存在 某 个 键 


【导语 】 

字典 中 每 个 项 都 由 键 (Key) 和 值 (Value) 组 成 ,其 中 , 键 是 用 来 对 该 项 进行 唯一 性 标识 
的 , 即 键 在 整个 字典 集合 中 是 无 重复 的 ,但 值 是 可 以 重复 的 。 

向 字典 集合 中 写 入 项 时 ,一 般 的 情况 是 : 如 果 某 个 键 不 存在 , 便 新 增 一 条 键 / 值 对 , 即 添 
加 新 项 ; 如 果 某 个 键 已 经 存在 , 则 将 与 该 键 对 应 的 值 蔡 换 掉 。 从 字典 集合 中 读 取 时 ,为 了 避 
免 访问 不 存在 的 键 ,在 读 取 之 前 应 该 先 检 测 一 下 键 的 存在 性 。 

字典 集合 类 型 (如 Hashtable、Dictionary 等 ) 会 公开 一 个 ContainsKey 方法 ,通过 该 方 
法 可 以 得 到 一 个 布尔 值 ,以 指示 要 查找 的 键 是 否 存在 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 ,以 便 访问 Dictionary 类 。 


using System. Collections. Generic; 
步骤 3: 创建 一 个 字典 实例 ,其 中 Key 的 类 型 为 string ,Value 的 类 型 为 double。 
IDictionary < string, double> dic = new Dictionary< string, double>(); 


步骤 4: 向 字典 中 添加 元 素 。 


dic["a"] = 0.0001d; 
dic["b"] = 0.0002d; 
dic["c"] = 0.0003d; 


步骤 5: 分 别 检 测 键 “a” 与 键 *b” 是 否 存在 于 字典 集合 中 。 


Console. WriteLine(" 键 "a"{0}"，dic. ContainsKey("a") ? "存在 ”: "不 存在 "); 
Console. WriteLine(" 键 "d"{0}"，dic. ContainsKey("d") ? "存在 ”: "不 存在 "); 


步骤 6: 运行 应 用 程序 ,控制 台 输 出 结果 如 下 。 
键 "a" 存 在 

键 "d" 不 存在 

实例 189 定义 索引 器 


【导语 】 
索引 器 跟 属性 比较 相似 ,同样 具有 get 和 set 访问 器 。 不 同 的 是 ,索引 器 带 有 一 个 参 
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数 一 一 即 索 引 。 例 如 ,可 以 用 以 下 名 式 访问 数组 中 某 个 元 素 。 
a = arr[2]; 


这 是 一 个 典型 的 索引 器 ,其 中 2 是 传递 给 索引 器 的 参数 。 
索引 器 的 声明 格式 如 下 。 


< 修饰 符 > < 类 型 > this[< 参 数列 表 >] 
{ 


get {°° } 
set{ … } 


} 


this 是 索引 器 的 固定 名 称 ,表示 通过 对 象 实例 进行 访问 。 中 括号 内 可 以 包含 多 个 参数 ， 
但 是 大 多 数 情况 下 只 定义 一 个 参数 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 类 ,里 面包 装 了 一 个 byte 数组 ,外 部 代码 可 以 通过 类 公开 的 索引 器 与 
byte 数组 交互 。PrintAll 方法 用 于 向 控制 台 输出 byte 数组 中 的 所 有 元 素 。 详 见 代 码 清单 6-7。 


代码 清单 6-7 带 索 引 器 的 示例 类 


public class MySample 
{ 
private byte[ ] _data = new byte[10]; 


public byte this[ int index] 
1 
get 
{ 
if (index <0 || index >= _data. Length) 
return 0; 
return _data[ index]; 


if (index>= 0 || index < _data. Length) 
‘ 

_data[ index] = value; 
} 


} 


public void PrintAll() 

{ 
string msg = string.Join("、", _data); 
Console. WriteLine( $ "元 素 列表 : \n{msg} \n\n"); 
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步骤 3: 创建 MySample 类 的 新 实例 。 


MySample sa = new MYSample() 


步骤 4: 通过 索引 器 ,向 实例 内 部 byte 数组 的 元 素 赋值 。 


sa[0] = 209; 
sa[1] = 39; 
sa[5] = 122; 
sa[9] = 60; 


步骤 $: 调用 一 次 PrintAll 方 法 ,输出 对 象 内 部 byte 数组 中 所 有 元 素 。 


sa. PrintAll(); 
步骤 6: 运行 应 用 程序 ,输出 结果 如 图 6-22 所 示 。 


CAprogramFiles\dotnet. 一 0O Xx 


图 6-22 输出 byte 数组 中 的 元 素 


实例 190” 带 多 个 参数 的 索引 器 


【导语 】 

索引 器 支持 多 个 参数 ,但 至 少 要 包含 一 个 参数 , 它 与 方法 不 同 ,方法 可 以 不 带 参 数 。 本 
实例 将 演示 一 个 带 两 个 参数 的 索引 器 (只 读 , 仅 包含 get 访问 器 ) ,并 返回 两 个 参数 的 乘积 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 类 ,其 中 包含 一 个 索引 器 。 该 索引 器 有 两 个 int 类 型 的 参数 ,并 返回 


这 两 个 参数 的 乘积 。 
public class Test 
{ 
public long this[ int a, int b] 
{ 
get 
{ 
returna * b; 
} 
} 


的 东西 位 于 箱子 底部 ,后 放 进去 的 东西 会 往 上 堆 重 
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步骤 3: 实例 化 Test 对 象 。 

Test t = new Test(); 

步骤 4: 通过 索引 器 计算 两 个 整数 值 的 乘积 。 
longr = t[800, 20000]; 

步骤 5: 输出 计算 结果 。 

Console. WriteLine( $ "计算 结果 : {r}"); 

步骤 6: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 
计算 结果 : 16000000 


实例 191 ”使 用 泛 型 的 栈 队列 
【导语 】 
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“ 栈 ” 是 一 种 数据 结构 , 它 的 特点 是 “后 进 先 出 ”。 它 犹如 一 个 单 向 开口 的 箱子 , 先 放 进 去 


面 的 东西 ,最 后 才能 取出 箱子 底部 的 东西 。 
Stack < > 是 栈 结构 的 泛 型 版 本 , 相 比 于 面向 object 类 型 的 版 本 ,使 用 泛 型 版 本 的 集合 
可 以 避免 频繁 的 类 型 转换 而 导致 的 性 能 损耗 。 
向 栈 队 列 中 添加 元 素 叫 入 栈 , 也 叫 压 栈 。 此 时 需要 调用 Push 方法 完成 人 栈 操作 。 相 
反 地 ,从 栈 队 列 中 取出 元 素 称 为 出 栈 ,或 叫 弹 栈 。 出 栈 需 要 调用 Pop 方法 ,该 方法 返回 取出 
元 素 , 并 从 栈 队列 中 删除 该 元 素 。 也 就 是 说 每 出 栈 一 个 元 素 ,Count 属性 就 会 减 1。 此 


的 


false, 而 不 会 抛 出 异常 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 实例 化 一 个 Stack<T > 对象, 类 型 参数 工 为 int 类 型 。 


Stack < int> st = new Stack< int >(); 
步骤 3: 调用 Push 方法 ,向 栈 队列 中 压 入 三 个 元 素 。 


st. Push(3); 
st. Push(2); 
st. Push(1); 


。 当 要 从 箱子 中 取出 东西 时 ,要 先 拿 掉 上 


外 ,还 有 一 个 Peek 方法 ,此 方法 也 能 取出 栈 队列 中 的 元 素 ,但 不 会 删除 该 元 素 。 若 希望 在 出 
栈 操 作 时 避免 错误 ,还 可 以 调用 TryPop 或 TryPeek 方法 。 这 两 个 方法 如 果 操 作 失 败 , 会 返 


步骤 4: 弹 栈 方法 一 ,调用 Pop 方法 让 元 素 出 栈 ,并 随时 检查 Count 属性 是 否 为 0。 


while (st.Count > 0) 
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Console. WriteLine(st.Pop()); 


步骤 5: 弹 栈 方法 二 ,调用 TryPop 方法 弹出 元 素 ,直到 其 返回 false( 栈 队列 中 已 无 元 素 )。 


while (st.TryPop(out int x)) 


Console. WriteLine(x); 


由 于 栈 队 列 遵 循 的 是 “后 进 先 出 ”顺序 ,上 面 代 码 中 , 放 入 栈 队 列 中 的 顺序 是 3、2、1, 而 
取出 来 的 顺序 应 当 为 1 .2、3。 


实例 192 ”自动 排序 的 字典 集合 


【导语 】 

SortedDictionary< TKey,， TValue > 与 常规 字典 集合 相 比 ,多 了 一 个 特殊 功能 一 一 自动 
排序 。 向 字典 中 添加 键 / 值 对 时 ,会 自动 将 集合 中 所 有 项 按照 键 (Key) 进 行 排序 。 

本 实例 将 演示 默认 排序 方案 , 即 按照 升序 排序 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 SortedDictionary <TKey, TValue > 实例 ,其 中 TKey 为 int 类 型 ,TValue 
为 string 类 型 。 

SortedDictionary < int, string> dic = new SortedDictionary < int, string>(); 

步骤 3: 向 字典 中 添加 项 目 。 

dic[20] = "hook"; 

dic[5] = "book"; 

dic[32] = "look"; 

dic[3] = "disk"; 

dic[12] = "list"; 

dic[7] = "foot"; 

上 述 代 码 中 ,为 每 个 项 设 定 的 Key 是 不 规律 的 ,添加 到 字典 集合 
后 ,会 自动 完成 排序 。 

步骤 4: 输出 字典 集合 中 每 个 项 的 Key 和 Value。 

foreach (var p in dic) 


{ 
Console. Write("{0} - {1}\n", p.Key, p.Value); 


} 图 6-23 完成 排序 后 
步骤 5: 运行 应 用 程序 ,会 看 到 如 图 6-23 所 示 的 输出 结果 。 的 键 / 值 对 
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实例 193” 自 定义 SortedDictionary 集合 的 排序 规则 


【导语 】 
SortedDictionary 类 的 构造 函数 中 有 以 下 重 载 : 


public SortedDictionary(IComparer < TKey > comparer); 


这 个 版 本 的 构造 函数 为 自 定义 排序 规则 提供 了 可 能 。 本 实例 将 演示 从 Comparer < 本 > 类 派 
生出 一 个 自 定义 的 比较 器 ,对 字符 串 的 长 度 进行 比较 。 最 终 实现 效果 是 让 SortedDictionary 
字典 的 Key 按照 字符 串 的 长 度 进行 升序 排序 , 即 字符 串 长 度 越 长 ,次 序 就 越 靠 后 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
步骤 3: 自 定 义 比 较 器 ,比较 两 个 字符 串 对 象 的 长 度 。 


public class CustSortComparer : Comparer < string> 
{ 
public override int Compare( string x, string y) 
{ 
return x. Length — y.Length; 
} 
. 


比较 代码 很 简单 ,将 两 个 字符 串 对 象 的 长 度 相 减 即 可 。 如 果 两 者 长 度 相 等 ,就 返回 0; 
如 果 x 的 长 度 大 于 y 的 长 度 ,就 返回 正 值 ; 如 果 x 的 长 度 小 于 y 的 长 度 ,就 返回 负 值 ,在 字 
典 集合 中 ,就 能 使 各 项 的 Key 按 字符 串 长 度 进行 升序 排列 了 。 

步骤 4: 在 Main 方法 中 创建 SortedDictionary 实例 ,并 向 构造 函数 传递 上 面 定义 的 
CustSortComparer 对 象 。 


SortedDictionary < string, DateTime > dic = new SortedDictionary < string, DateTime > ( new 
CustSortComparer( )); 


步骤 5: 向 字典 中 添加 项 ,注意 各 项 的 键 长 度 。 


dic["ab"] = new DateTime(2018, 1, 1); 
dic["hijklmn"] = new DateTime(2018, 1, 3); 
dic["opqr"] = new DateTime(2018, 1, 5); 
dic["s"] = new DateTime(2018, 1, 7); 
dic["stuvwxyz"] = new DateTime(2018, 1, 9); 


步骤 6: 尝试 将 字典 中 的 各 项 输出 。 


foreach (var dp in dic) 
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{ 
Console. Write( $ "{dp. Key, — 10} — {dp. Value}\n"); 


} 
步骤 7: 运行 应 用 程序 ,输出 结果 如 图 6-24 所 示 。 


CAprogram Files.. 一 (= 
ls i=7 


图 6-24 ”字典 中 的 Key 按 字符 串 长 度 排序 


实例 194 “先进 先 出 ”队列 


【导语 】 

“后 进 先 出 ”, 即 栈 , 最 后 放 进 去 的 元 素 最 先 被 取出 来 。 而 双向 链表 就 相当 于 两 端 开口 的 
管子 ,元素 从 一 边 进 去 ,再 从 另 一 边 出 来 , 即 先进 去 的 元 素 可 最 先 被 取出 。 

双向 链表 有 两 个 相关 的 类 型 : 一 个 是 以 object 类 型 为 基础 的 , 即 Queue 类 ; 另 一 个 是 
泛 型 集合 Queue <T>, 它 带 有 类 型 参数 ,可 以 根据 需要 指定 元 素 的 类 型 。 

要 操作 Queue < 本 > 类 ,可 以 调用 以 下 几 个 方法 : 

(1) Enqueue: 向 链表 中 添加 元 素 ( 入 队 ) 。 

(2) Dequeue: 从 链表 中 取出 元 素 ( 出 队 ) ,然后 该 元 素 会 被 删除 。 

(3) Peek: 从 链表 中 取出 元 素 ,但 不 删除 元 素 。 

(4) TryDequeue 与 TryPeek: 从 链表 中 取出 元 素 ,发 生 错 误 时 不 会 抛 出 异常 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 Queue < > 实例 ,参数 本 为 int 类 型 。 


Queue < int > q = new Queue < int >(); 
步骤 3: 向 队列 添加 一 些 元 素 。 


q. Enqueue(3); 
q. Enqueue(2); 
q. Enqueue(1); 


步骤 4: 从 队列 中 取出 所 有 元 素 ,并 输出 。 


while(q. TryDequeue(out int x)) 
{ 
Console. WriteLine(x); 


} 
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当 队 列 中 的 元 素 被 取 完 后 ,TryDequeue 方法 会 返回 false, 所 以 可 以 用 一 个 while 循环 
来 取出 所 有 元 素 。 元 素 进去 时 的 顺序 为 3、2、1, 根 据 “ 先 进 先 出 ”的 规律 ,最 后 输出 的 顺序 也 
是 32 


实例 195” 自 定义 ToReadOnlyDictionary 方法 


【导语 】 

在 某 些 特定 的 应 用 场景 中 ,程序 创建 字典 集合 的 实例 后 ,并 不 希望 字典 中 的 数据 被 修 
改 , 即 只 读 字典 。 在 . NET 类 库 中 ,有 一 个 名 为 ReadOnlyDictionary 的 泛 型 类 ,该 类 可 以 通 
过 现 有 的 字典 集合 创建 一 个 只 读 的 字典 集合 。 

下 面 代码 演示 如 何 创 建 只 读 的 字典 集合 。 


IDictionary< int, string> srcdic = new Dictionary< int, string>(); 


srcdic[1] = "a"; 
srcdic[2] = "b"; 
srcdic[3] = "ec"; 


ReadOnlyDictionary < int, string> rodic = new ReadOnlyDictionary< int, string>(srcdic); 


而 本 实例 则 是 通过 对 IDictionary < TKey, TValue > 接口 进行 扩展 ,使 生成 只 读 字 典 的 
功能 更 具 通 用 性 和 灵活 性 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 一 个 DictionaryExtensions 类 ,在 类 中 定义 扩展 方法 ,对 IDictionary 接口 
进行 扩展 ,返回 一 个 只 读 字典 集合 。 
public static class DictionaryExtensions 
{ 
public static IReadOonlyDictionary < TKey, TValue > ToReadOnlyDictionary < TKey, TValue > 
(this IDictionary < TKey, TValue> srcDictionary) 
{ 


return new ReadOnlyDictionary < TKey, TValue >(srcDictionary); 


} 


注意 : 包含 扩展 方法 的 类 要 声明 为 静态 类 ,扩展 方法 也 要 声明 为 静态 的 。 


步骤 3: 在 Program 类 中 定义 一 个 方法 ,用 于 返回 一 个 只 读 字典 集合 实例 ,在 方法 的 实 
现代 码 中 ,调用 上 面 定义 的 扩展 方法 。 

static IReadOnlyDictionary < string, string> GetReadOnly() 

{ 


IDictionary < string, string>d = new Dictionary< string, string>(); 
d["city"] = "Guang Zhou"; 


234 二 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


d["name"] = "Mr Liu"; 

d["subject"] = "ASP.NET Core"; 

return d. ToReadOnlyDictionary(); 
} 
在 产生 只 读 字典 前 ,要 先 初 始 化 可 读 可 写 的 字典 集合 ,否则 无 法 存 人 数据 。 
步骤 4: 在 Main 方法 中 ,尝试 调用 GetReadOnly 方法 。 


IReadOnLYDIGtHionary < Htring, stiiig> dic = GetReadonly(); 
步骤 5: 输出 只 读 字典 中 各 项 的 Key 和 Value。 


foreach( string key in rdic. Keys) 


{ 


Console. WriteLine("{0} — {1}", key, rdic[key]); 
. 


步骤 6: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 6-25 所 示 。 


实例 196 ”初始 化 字典 集合 的 方法 


【导语 】 
有 三 种 初始 化 字典 集合 的 方法 。 
(1) 调用 Add 方法。 


图 6-25 只 读 字典 中 的 数据 


Dictionary < int, double> dict = new Dictionary< int, double>(); 
dict. Add(200, 0.000021d); 


Add 方 法 的 第 一 个 参数 是 新 元 素 的 Key, 第 二 个 参数 是 新 元 素 的 Value。 如 果 Key 已 经 存 
在 ,会 替换 Value。 

(2) 通过 索引 器 赋值 。 

IDictionary < float，float> dicx = new Dictionary<float, float >(); 


dicx[0.1f] = 0.00001f; 
dicx[0.2f] = 0.00002f; 


(3) 在 调用 构造 函数 后 立即 填充 元 素 。 


Dictionary < string, int > d2 = new Dictionary< string, int> 


["a"] = 100, 
["b"] = 200, 
["c"] = 300 
}; 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


第 6 章 ” 泛 型 与 集合 | 有 235 


步骤 2: 创建 第 一 个 字典 对 象 ,使 用 索引 器 来 初始 化 。 


Dictionary < string, string> dicl = new Dictionary< string, string>(); 


dicl["kl"] = "val 1"; 
dell 2 = wal 
dicl["k3"] = "val 3"; 


步骤 3: 创建 第 二 个 字典 对 象 ,调用 Add 方法 初始 化 。 


Dictionary< int, long> dic2 = new Dictionary< int, long>(); 
dic2. Add(1, 1560000); 
dic2. Add(2, 1570000); 
dic2. Add(3, 1580000); 


步骤 4: 创建 第 三 个 字典 对 象 ,在 调用 构造 函数 之 后 马上 初始 化 。 


Dictionary < decimal, DateTime> dic3 = new Dictionary < decimal, DateTime> 


{ 


[12M] = new DateTime(2017, 9, 1), 
[13M] = new DateTime(2017, 10, 1), 
[14M] = new DateTime(2017, 11, 1) 
}; 
实例 197 ArrayList 的 使 用 
【导语 】 


ArrayList 类 与 List<T> 有 些 类 似 ,支持 在 集合 中 添加 和 删除 元 素 ,但 是 ArrayList 是 
面向 object 类 型 的 , 读 写 元 素 的 过 程 中 会 发 生 大 量 的 类 型 转换 ,从 而 增加 性 能 开销 。 因 此 ， 
比较 庞大 的 集合 应 当 优 先 考 虑 使 用 泛 型 集合 ,而 小 型 集合 使 用 ArrayList 类 所 带 来 的 性 能 
开销 较 小 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 一 个 ArrayList 集合 。 


ArrayList list = new ArraybList(); 
步骤 3: 添加 三 个 元 素 。 


list. Add(5580); 
list. Add(7899878L); 
list. Add( 'v'); 


步骤 4: 删除 集合 中 的 第 一 个 元 素 。 
list. RemoveAt(0); 


RemoveAt 方法 可 以 把 指定 索引 处 的 元 素 移 除 。 
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步骤 5: 再 添加 两 个 元 素 。 

list. Add("test"); 

list. Add( (uint)36000); 

由 于 常量 表达 式 36000 默认 被 识别 为 int 类 型 ,而 此 处 希望 添加 的 数据 类 型 是 uint, 因 
此 要 显 式 地 进行 类 型 转换 。 

步骤 6: 输出 集合 中 的 元 素 , 以 便 观 察 。 


foreach(object o in list) 


{ 
Console. WriteLine(o); 


» 
步骤 7: 此 时 ,集合 中 应 有 4 个 元 素 , 输 出 的 内 容 如 下 。 


7899878 
MA 

test 
36000 


实例 198 ”使 用 Span < 了 > 提升 处 理 字符 串 的 性 能 


【导语 】 

.NET 中 许多 类 型 都 是 在 托管 堆 中 分 配 内 存 的 ,在 对 连续 内 存 块 进行 操作 时 , 某 些 数据 
类 型 会 比较 花 时 间 , 其 中 最 典型 的 是 字符 串 。 在 处 理 字符 串 的 过 程 中 会 不 断 创建 新 的 实例 ， 
这 些 过 程 必 将 占用 一 定 的 时 间 。 

.NET Core 类 库 提供 了 一 种 特殊 的 结构 一 一 Span <T>, 它 可 以 用 于 操作 各 种 连续 分 
布 的 内 存 数据 。 可 以 通过 以 下 来 源 初始 化 Span < >。 

(1) 常见 的 托管 数组 。 

(2) 栈 内 存 中 的 对 象 。 

(3) 本 地 内 存 指针 。 

此 外 ,Span < 了 > 支持 GC 功能 ,不 需要 显 式 释放 内 存 。 与 Span<T> 对 应 ,还 有 一 个 只 
读 版 本 一 一 ReadOnlySpan< 工 >。 

本 实例 演示 了 用 两 种 方法 将 某 个 字符 串 中 的 两 个 字符 (“2” 和 “0”) 转 换 为 int 数值 20， 
并 且 使 用 Stopwatch 组 件 分 别 计算 两 种 方法 所 消耗 的 时 间 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 并 初始 化 一 个 字符 串 实例 , 稍 后 做 测试 使 用 。 


string str = "我 家 里 养 了 20 只 猫 "; 
步骤 3: 第 一 种 处 理 方法 ,调用 Substring 方法 取出 *2” 和 “0” 两 个 字符 ,再 通过 Parse 方 
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法 产生 int 实例 。 


Stopwatch swl = Stopwatch. StartNew(); 
for(int x = 0; x< 10000000; x++) 
{ 
int v = int.Parse(str.Substring(5, 2)); 
. 
swl. Stop(); 
Console. WriteLine( $ "常规 方法 : 耗 时 {swl. ElapsedMilliseconds} ms"); 


步骤 4: 第 二 种 方法 ,使 用 Span<T 了 >,T 为 char 类型。 调用 Slice 方法 取出 *2” 和 “0” 两 
个 字符 ,再 通过 自 定义 代码 将 其 转换 为 int 值 。 


Stopwatch sw2 = Stopwatch. StartNew(); 
ReadOnlySpan < char > span = str.ToCharArray(); 
for (int x = 0; x<10000000; x++) 
{ 
intv = 0; 
var subspan = span.Slice(5, 2); 
for(int i = 0; i< subspan. Length; i++) 
t 
char ch = subspan[i]; 
v= (ch— '0')+v a 10; 
} 
} 
sw2. Stop( ); 
Console. WriteLine( $ "使 用 Span: 耗 时 {sw2. ElapsedMilliseconds} ms"); 


由 于 从 Span 实例 中 取出 来 的 元 素 是 char 类 型 ,为 了 能 得 
到 与 字符 相对 应 的 整数 值 ,应 该 将 其 减 去 字符 “0” 的 ASCII 码 。 
字符 “0” 的 ASCII 码 是 48, 以 此 类 推 ,字符 “1” 的 ASCII 码 为 
49 ,字符 “2? 的 ASCII 码 为 50, 如 果 要 使 字符 “2” 与 整数 2 对 应 ， 


"OPro. 一 DO X 


1011 ms A 


就 要 用 50 减 去 48。 图 6-26 ”两 种 处 理 方法 
步骤 5: 运行 应 用 程序 ,如 图 6-26 所 示 , 通 过 对 比 代 码 执行 的 本 且 红 比 


时 间 , 采 用 Span< 工 > 的 效率 较 高 。 


注意 : 为 了 能 让 对 比 的 效果 更 直观 ,本 实例 在 一 个 for 循环 中 将 每 种 处 理 方法 的 代码 重复 执 
行 了 10000000 次 。 
在 计时 的 时 候 ,Stopwatch 组 件 自身 也 会 消耗 一 定 的 CPU 资源 ,因此 代码 执行 所 耗 
费 的 准确 时 间 与 Stopwatch 所 计算 的 结果 会 存在 误差 , 仅 用 于 参考 。 
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实例 199 ”多 个 Task 同时 操作 ConcurrentBag 集合 
【导语 】 


ConcurrentBag < 本 > 是 一 个 泛 集合 , 它 较为 明显 的 优点 是 可 以 在 多 个 线程 上 同时 访问 ， 
并 且 该 集合 是 无 序 的 , 即 从 集合 中 取出 元 素 的 顺序 可 能 与 放 入 的 顺序 不 一 致 。 

要 向 集合 中 添加 元 素 可 以 调用 Add 方法 。 而 取出 元 素 则 有 两 个 方法 可 用 : TryTake 
方法 取出 元 素 然 后 把 元 素 从 集合 中 删除 ,TryPeek 方法 取出 元 素 但 不 会 删除 元 素 。 

要 判断 ConcurrentBag < 工 > 集合 中 是 否 存在 元 素 , 一 种 方法 是 访问 Count 属性 , 它 表 
示 集 合 中 包含 元 素 的 个 数 ; 另 一 种 方法 是 访问 IsSEmpty 属性 ,如 果 集合 为 空 则 返回 true。 


【操作 流程 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 实例 化 ConcurrentBag < 本 > 集合 ,参数 丁 为 int 类 型 。 


ConcurrentBag < int > bag = new ConcurrentBag < int >(); 


步骤 3: 在 项 目 生成 的 Program. cs 文件 头 部 的 using 指令 块 中 ,添加 对 以 下 命名 空间 


的 引用 。 


using System. Collections. Concurrent; 
using System. Threading. Tasks; 


步骤 4: 启动 第 一 个 Task, 向 集合 中 添加 元 素 。 


Task tl = Task.Run(() => 
{ 
for (int k = 45; k <51; k++) 
{ 
Console. WriteLine(" 即 将 添加 元 素 :{0}"，k); 
bag. Add(k); 
} 
}); 


步骤 5: 启动 第 二 个 Task, 从 集合 中 取出 元 素 , 此 Task 在 第 一 个 Task 执行 之 后 执行 。 


Task t2 = t1.ContinueWith( (task) => 
{ 
while (!bag. IsEmpty) 
{ 
if(bag. TryTake(out int item)) 
{ 
Console.WriteLine(" 已 取出 元 素 :{0}"，item); 
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ContinueWith 方法 指定 在 某 个 Task 之 后 延续 新 的 Task。 如 果 
两 个 Task 同时 执行 ,由 于 集合 的 初始 状态 是 空 的 ,会 导致 第 二 个 
Task 中 无 法 获取 到 元 素 。 所 以 要 让 第 一 个 Task 先 执行 ,这 样 在 执行 
第 二 个 Task 时 ,就 能 保证 集合 中 是 有 元 素 的 。 

步骤 6: 调用 WaitAll 方法 ,让 当前 线程 暂停 执行 ,等 待 上 面 两 个 
Task 执行 完成 再 继续 。 


Task. WaitAll(t1, t2); 


步骤 7: 运行 应 用 程序 ,控制 台 输 出 信息 如 图 6-27 所 示 。 
实例 200” 跨 线程 访问 BlockingCollection 集合 


【导语 】 

BlockingCollection<T > 集合 允许 多 线程 访问 (添加 或 移 除 元 素 )。 当 集合 中 的 元 素数 
量 达 到 容量 上 限时 ,添加 操作 会 被 阻止 ,直到 集合 中 有 元 素 被 移 除 (重新 获得 可 用 容量 ); 同 
样 地 , 当 从 集合 中 移 除 元 素 时 ,如 果 集 合 中 无 可 用 元 素 ,那么 移 除 操作 会 被 阻止 ,直到 集合 中 
有 新 的 元 素 加 入 。 

多 个 线程 可 以 同时 调用 Add 或 TryAdd 方法 向 集合 添加 元 素 , 也 可 以 同时 调用 Take 
或 TryTake 方法 移 除 元 素 。 当 调用 CompleteAdding 方法 后 ,就 不 能 再 向 集合 中 添加 元 素 
了 ,和 否则 会 引发 异常 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 BlockingCollection<T > 实例 ,T 为 int 类 型 。 


图 6-27 跨 线程 添加 
和 读 取 元 素 


using (BlockingCollection< int > bc = new BlockingCollection< int >()) 
{ 


’ 

BlockingCollection < 本 > 类 实现 了 IDisposable 接口 , 若 不 再 使 用 要 将 其 释放 。 将 初始 
化 代码 放 在 using 语句 块 中 ,当代 码 离开 using 块 时 会 自动 调用 Dispose 方法 。 

步骤 3: 在 using 代码 块 内 部 ,创建 第 一 个 Task, 用 于 向 集合 添加 元 素 。 


Task tl = Task.Run(async () => 
{ 
for (intk = 0; k<5; k++) 
{ 
int item = k + 1; 
Console. WriteLine( "即将 添加 元 素 :{0}"，itenm); 
bc. Add( item); 
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会 变 为 true, 此 时 就 可 以 退出 while 循环 了 。 


放 上 述 两 个 Task。 


await Task. Delay(650); 
} 
// 标记 添加 操作 已 完成 
bc. CompleteAdding( ); 
D); 


在 调用 CompleteAdding 方法 后 ,集合 被 标记 为 已 完成 添加 操作 ,此 时 所 有 线程 均 无 法 


再 向 集合 添加 元 素 。 


步骤 4: 创建 第 二 个 Task, 用 于 从 集合 中 移 除 元 素 。 


Task t2 = Task.Run(() => 
{ 


while (true) 


{ 


if (bc, TryTake(out int item)) 
{ 
Console. WriteLine(" 取 出 元 素 :{0}"，item) ; 
} 
// 是 否 退 出 循环 
if (bc. IsCompleted) break; 
} 
D); 


当 集 合 中 的 所 有 元 素 都 被 移 除了 ( 空 集合 ) ,IsCompleted 属性 


步骤 5: 调用 WaitAll 方 法 等 待 所 有 Task 执行 完成 ,然后 释 


Task. WaitAll(t1, t+2); 
t1.Dispose(); 
t2. Dispose(); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 6-28 所 示 。 5928 路线 程 添加 
和 移 除 元 素 


6.4 元 组 


因 
证 


元 组 


实例 201 Tuple 类 的 使 用 


【导语 】 
简单 地 说 ,元 组 就 是 将 一 组 松散 的 对 象 简单 地 组 合 在 一 起 。 元 组 比 数组 的 灵活 性 略 强 ， 


为 数组 中 所 有 元 素 的 类 型 是 统一 的 ,而 元 组 使 用 了 泛 型 参数 ,使 得 每 个 元 素 的 类 型 相互 独 
元 组 不 同 于 类 和 结构 ,类 和 结构 是 高 度 整合 的 数据 类 型 ,其 中 要 实现 各 种 复杂 的 功能 


只 是 一 系列 单一 对 象 的 简单 组 合 ,不 存在 复杂 的 操作 。 
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.NET 框架 最 早 引 入 元 组 的 概念 ,是 通过 Tuple 类 实现 的 ,而 且 存在 多 个 泛 型 版 本 ,可 
容纳 元 素数 量 为 1 一 8 个 。 元 组 中 将 所 有 元 素 分 配给 Item * 属性 ,其 中 * 表示 序号 ,例如 
Iteml Item2 \Item3 等 ,Item * 属性 个 数 取 决 于 元 素 的 个 数 。 

创建 元 组 实例 有 两 种 方法 : 

(1) 直接 调用 泛 型 版 本 Tuple 类 构造 函数 。 例 如 要 创 到 
对 象 的 元 组 ,并 按 下 列 格式 实例 化 。 


以 


-个 三 元 组 , 即 可 以 组 合 三 个 


Tuple < int，long，char> 七 = new Tuple < int, long, char >(1000, 20000L, 'p'); 


以 上 代码 创建 了 三 元 组 实例 ,其 中 ,Iteml 是 int 类 型 ,Item2 是 long 类 型 ,Item3 是 
char 类 型 。 

(2) 直接 调用 Tuple 类 的 Create 方法 ,此 方法 为 静态 方法 ,格式 如 下 。 

var k = Tuple.Create<byte, string>(255, "fu11"); 

以 上 代码 创建 了 一 个 二 元 组 实例 ,Iteml 为 byte 类 型 ,Item2 为 string 类 型 。 方 法 返回 
一 个 Tuple < T1，T2 > 对 象 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 三 元 组 实例 ,元 素 类 型 都 是 string。 


Tuple < string, string, string > tl = new Tuple < string, string, string >("make", "it", 
"easy"); 


步骤 3: 输出 三 元 组 中 Iteml1、Item2 和 Item3 的 数据 类 型 与 对 应 的 值 。 


Console. WriteLine(" 三 元 组 :"); 

string msg = $"{nameof(t1. Item1)}:{t1. Iteml.GetType().Name} = {tl1.Iteml}\n{nameof(t1. 
Item2)}:{t1. Item2. GetType().Name} = {tl1. Item2}\n{nameof (tl1. Item3)}:{t1. Item3. GetType(). 
Name} = {t1.Item3}"; 

Console. WriteLine(msg); 


步骤 4: 再 创建 一 个 二 元 组 ,元 素 类 型 分 别 为 int 和 uint。 
Tuple < int, uint > t2 = new Tuple< int, uint >(70000, 950000); 


步骤 5: 输出 二 元 组 中 Iteml 和 Item2 的 数据 类 型 与 对 应 的 值 。 


Console. WriteLine("\n 二 元 组 :"); 

msg = $"{nameof(t2. Iteml )} : {t2. Iteml. GetType( ). Name} = {t2. 
Iteml}\n{ nameof (t2. Ttem2 ) } : {t2. Ttem2. GetTYpe( ). Name} = {t2. 
Item2}"; 

Console. WriteLine(msg); 


步骤 6: 运行 应 用 程序 项 目 ,控制 台 输 出 的 信息 如 图 6-29 图 6-29 输出 两 个 元 组 
所 示 。 的 相关 信息 
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实例 202 ”推荐 使 用 的 元 组 一 一 ValueTuple 


【导语 】 

ValueTuple 的 使 用 方法 与 Tuple 类 似 , 但 ValueTuple 是 值 类 型 ,不 需要 分 配 堆 内 存 ， 
效率 更 优 于 Tuple 类 。 此 外 ,ValueTuple 的 Item * 成 员 都 是 公共 字段 ,这 使 得 ValueTuple 
在 初始 化 之 后 仍然 可 以 修改 元 素 。 

与 Tuple 类 一 样 ,ValueTuple 也 有 两 种 初始 化 方法 : 一 种 是 直接 调用 构造 函数 初始 
化 ; 另 一 种 是 调用 静态 的 Create 方法 直接 获得 元 组 实例 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 四 元 组 ,元 素 类 型 分 别 为 short、uint、ulong 和 string。 


ValueTuple < short, uint, ulong, string> tl = ValueTuple. Create < short, uint, ulong, string> 
(160, 300, 50000000UL, "head"); 


步骤 3: 使 用 StringBuilder 类 组 装 要 输出 的 元 组 信息 ,包括 Item * 字段 的 类 型 和 具体 
内 容 。 


StringBuilder strbd = new StringBuilder(); 

strbd. AppendLine(" 四 元 组 :"); 

strbd. AppendFormat (" {0}:{1} = {2}\n", nameof (tl1. Iteml )，tl1. Item1. GetType( ). Name, t1. 
Iteml ) ; 

strbd. AppendFormat (" {0}:{1} = {2}\n", nameof (tl1. Item2), t1. Item2. GetType( ). Name, t1. 
Item2); 

strbd. AppendFormat ("{0}:{1} = {2}\n", nameof (t1. Item3), t1. Item3. GetType( ). Name, t1. 
Item3); 

strbd. AppendFormat ("{0}:{1} = {2}\n", nameof (t1. Item4), t1. Item4. GetType( ). Name, t1. 
Item4); 


步骤 4: 再 创建 二 元 组 ,元 素 类 型 为 bool 和 byte。 
ValueTuple< bool]l, byte> t2 = ValueTuple.Create < bool, byte>(false, 100); 
步骤 5: 向 StringBuilder 对 象 追加 Item * 字段 的 信息 。 


strbd. AppendbLine("\n\n 二 元 组 :"); 

strbd. AppendFormat (" {0}:{1} = {2}\n", nameof (t2. Iteml )，t2. Item1. GetType( ). Name, t2. 
Iteml ) 

strbd. AppendFormat (" {0}:{1} = {2}\n", nameof (t2. Item2), t2. Item2. GetType( ). Name, t2. 
Item2); 


步骤 6: 尝试 修改 二 元 组 中 Item2 字段 的 值 。 


t2. Iten2 = 210; 
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步骤 7: 将 修改 后 的 新 值 也 追加 到 StringBuilder 对 
象 中 


strbd. AppendFormat( "修改 后 , {0} = {1}",， nameof(t2. Item2)， 
t2. Item2); 


步骤 8: 将 StringBuilder 对 象 中 的 字符 串 全 部 输出 到 控 
制 台 。 


Console, WriteLine(strbd) ; 


图 6-30 输出 ValueTuple 


步骤 9: 运行 应 用 程序 ,输出 结果 如 图 6-30 所 示 。 的 Item x 字段 信息 
实例 203 C# 语 法 中 的 ValueTuple 
【导语 】 


ValueTuple 结构 得 到 C# 语 法 的 支持 ,可 以 使 用 简洁 的 语法 在 代码 中 直接 声明 元 组 。 
vara = (100, (byte)15, true); 

也 可 以 在 声明 时 明确 ValueTuple 的 类 型 。 

ValueTuple < string, string>b = ("Jack", "Bob"); 

还 可 以 选择 更 简洁 的 方式 声明 。 

(long, uint) £ = (123454321L, 7899); 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 三 元 组 并 初始 化 ,元 素 类 型 分 别 为 string .string 和 byte。 


(string, string, byte) x = ("subject", "body", 26); 


步骤 3: 输出 三 元 组 中 Item x* 字段 的 值 。 


Console. WriteLine(" 三 元 组 :\nIteml = {0}\nItem2 = {1}\nItem3 = {2}\n", x.Iteml, x. Item2, 
x. Item3); 


步骤 4: 再 声明 一 个 二 元 组 ,初始 化 时 直接 用 两 个 DateTime 实 
例 填充 ,编译 时 会 自动 推断 出 该 二 元 组 的 元 素 类 型 均 为 DateTime。 


vary = (new DateTime(2017, 1, 1), new DateTime(2018, 1, 1)); 
步骤 5: 输出 二 元 组 中 Item * 字段 的 值 。 


Console. WriteLine(" 二 元 组 :\nIteml = {0:d}\nItem2 = {1:d}", y. 
Iteml, y. Item2); 


图 6-31 输出 两 个 元 组 
中 各 字段 的 值 步骤 6: 运行 应 用 程序 项 目 ,控制 台 输 出 内 容 如 图 6-31 所 示 。 
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实例 204” 重 命名 元 组 的 字段 


【导语 】 

在 . NET 基础 类 型 中 ,ValueTuple 结构 的 字段 都 以 Item * 来 命名 ,这 样 在 编写 代码 时 
并 不 方便 ,因此 基于 C# 语 言 编译 器 支持 对 元 组 中 的 字段 使 用 自 定义 命名 。 但 在 运行 阶段 ， 
依然 是 以 ValueTuple 为 基础 的 ,为 字段 重 命名 仅仅 是 编程 语言 的 功能 。 

例如 ,以 下 代码 声明 三 元 组 。 


(int ID, string Title, string Body) v = (1, "demo", "some one"); 


此 时 ,Iteml 字段 被 重 命 名 为 ID,Item2 字段 被 重 命名 为 Title, Item3 字段 被 重 命名 为 
Body。 在 访问 时 ,可 以 直接 使 用 自 定义 的 字段 名 。 


v.Title = "the best" 
也 可 以 用 var 关键 字 先 声明 元 组 ,初始 化 时 再 重 命名 字段 。 
varw = (Count: 999, Symb: '# )); 


以 上 代码 中 ,编译 器 会 根据 赋值 推断 出 Count 字段 为 int 类 型 ,Symb 字段 为 char 
类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 二 元 组 ,元 素 类 型 都 是 double。 


(double x, double y) d = (0.000025d, 3.115d); 
步骤 3: 将 元 组 中 的 字段 相 乘 ,并 输出 计算 结果 。 
Console. WriteLine("x * y = {0}", d.x * d.y); 


步骤 4: 为 了 验证 元 组 的 基础 类 型 为 ValueTuple, 可 以 通过 反射 技术 输出 元 组 中 各 个 
字段 在 运行 时 的 名 称 以 及 所 属 的 数据 类 型 。 


// 运行 时 类 型 
Type t = d.GetType(); 
// 获取 字段 列表 
var fds = t.GetFields(BindingFlags.Public | BindingFlags. Instance) ; 
Console. WriteLine(" 元 组 的 运行 时 类 型 :{0}"，t. Name) ; 
string infos = string. Empty; 
foreach (var f in fds) 
{ 
infos += $"{f.Name}:{f.FieldType. Name}\n"; 
} 
Console. WriteLine(" 各 字段 名 称 与 类 型 :\n{0}"，infos); 
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步骤 5: 运行 应 用 程序 ,输出 结果 如 图 6-32 所 示 。 从 输出 内 容 可 以 看 出 ,元 组 的 实际 类 
型 是 ValueTuple< Tl1, T2 >。 尽 管 在 代码 中 对 字段 进行 了 重 命名 ,而 其 实际 字段 名 称 依然 
是 Iteml 和 Item2。 


图 6-32 输出 元 组 在 运行 时 的 实际 类 型 


实例 205 ”将 元 组 解构 为 变量 

【导语 】 

声明 元 组 时 ,如 果 不 使 用 变量 名 , 则 编译 器 会 将 元 组 中 的 各 个 字段 自动 解构 为 单独 的 变 
量 , 其 语法 如 下 。 

(< 类 型 > < 字段 >，< 类 型 > < 变量 >，… … ) = ( < 为 字段 分 配 的 值 > ); 

这 样 声明 之 后 ,元 组 中 的 每 个 字段 都 可 以 作为 单独 的 变量 被 访问 。 当 然 也 可 以 用 var 
关键 字 来 声明 。 

var ( < 字段 列表 > ) = ( < 为 字段 赋值 > ) 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 三 元 组 ,并 让 字段 解构 为 变量 。 

(long BookID，string BookName, string Author) = (10000031L, "Sample Book", "Tommy"); 

步骤 3: 输出 各 字段 的 内 容 。 

Console. WriteLine( $ "编号 :{BookID}\n 书 名 :{BookNamej\n 作者 :{Author}"); 

解构 之 后 ,元 组 中 的 字段 可 作为 普通 变量 来 使 用 。 

步骤 4: 运行 应 用 程序 项 目 ,控制 台 输出 内 容 如 下 。 


编号 :10000031 
书 名 :Sample Book 
作者 :Tommy 


实例 206 解构 自 定义 类 型 
【导语 】 
C# 语 言 的 元 组 还 支持 将 用 户 自 定义 的 类 型 进行 解构 , 即 可 以 将 某 个 类 的 属性 解构 为 
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元 组 。 使 类 型 支持 解构 为 元 组 的 方法 是 : 在 类 型 中 定义 一 个 公共 方法 ,返回 类 型 为 void, 必 
须 将 方法 命名 为 Deconstruct。 组 成 新 元 组 的 元 素 由 Deconstruct 方法 的 out 参数 决定 ,一 
个 类 型 中 可 以 定义 多 个 Deconstruct 方法 以 解构 出 不 同 元 素 个 数 的 元 组 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 自 定义 类 。 


public class Order 

{ 
public int OID { get; set; } 
public string CustomName { get; set; } 
public string ContactName { get; set; } 
public float Amount { get; set; } 
public string PhoneNo { get; set; } 

» 


步骤 3: 在 Order 类 中 定义 Deconstruct 方法 ,将 Order 类 的 五 个 属性 进行 解构 。 


public void Deconstruct(out int oid, out string custName，out string contact, out float amount, 
out string phone) 
{ 
oid = OID; 
custName = CustomName; 
contact = ContactName; 
amount = Amount; 
phone = PhoneNo; 
} 


步骤 4: 在 Main 方法 中 实例 化 一 个 Order 对 象 ,并 对 属性 进行 初始 化 。 


Order o = new Order 
{ 
OID = 6012001, 
CustomName = "XXX 贸易 有 限 公 司 "， 
ContactName = " 刘 先 生 "， 
Amount = 1700.34f, 
PhoneNo = "13322500121" 
}; 


步骤 5: 对 Order 实例 进行 解构 。 
var (id, cust, contact, amout, phone) = oj 
步骤 6: 输出 解构 后 的 元 组 字段 。 


Console. WriteLine( $ "订单 号 :{idj\n 客户 单位 :{cust}j\n 联系 
人 :{contact}\n 订购 数量 :{amout}\n 电话 :{phone}"); 


步骤 7: 运行 应 用 程序 项 目 .输出 结果 如 图 6-33 所 示 。 ”图 6-33 输出 解构 后 变量 的 值 
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实例 207 将 元 组 作为 返回 值 


【导语 】 

元 组 的 男 一 个 作用 一 一 充当 方法 的 返回 值 。 尤 其 是 在 一 个 方法 中 需要 同时 返回 多 个 对 
象 给 调用 方 的 时 候 , 虽 然 可 以 使 用 out 参数 ,但 使 用 元 组 可 以 更 简洁 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 返回 三 元 组 的 方法 。 

static (string, int, string) GetData() 

' 


return ("Test 1", 35, "Test 2"); 


了 
该 方法 没有 对 元 组 中 的 字段 进行 重 命名 ,因此 三 个 字段 的 名 字 分 别 为 : Iteml ,Item2、 


Item3 。 


步骤 3: 调用 上 述 方法 ,获取 返回 的 元 组 后 ,不 对 字段 重 命名 ,直接 输出 。 


var k = GetData(); 
Console. WriteLine(" 未 对 字段 重 命 名 :"); 
Console. WriteLine("Iteml = {0}, Item2 = {1}, Item3 = {2}", k.Iteml, k.Item2, k.Item3); 


步骤 4: 也 可 以 在 获取 返回 的 元 组 后 ,对 字段 重 命名 。 


var (Markl, Count, Mark2) = GetData(); 

Console. WriteLine("\n 对 字段 进行 重 命名 :"); 

Console. WriteLine( $ " {nameof (Mark1)} = {Markl}, {nameof (Count)} = {Count}, {nameof 
(Mark2)} = {Mark2}"); 


步骤 5: 在 Program 类 中 再 定义 一 个 方法 ,在 返回 二 元 组 时 , 重 命名 字段 。 


static (int Numberl, int Number2) GetNumbers() 
{ 

Random rand = new Random(); 

return (rand. Next(0, 1000), rand. Next(0, 1000)); 
} 


步骤 6: 调用 方法 ,获取 返回 的 元 组 ,并 直接 访问 已 经 命名 的 字段 。 


var d = GetNumbers(); 

Console. WriteLine("\n 返回 带 重 命 名 字段 的 元 组 :"); 

Console. WriteLine ( $ " {nameof (d. Number1)} = {d. Number1}, {nameof (d. Number2)} = {d. 
Number2}"); 
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步骤 7: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 6-34 所 示 。 


6-34 ”获取 方法 返回 的 元 组 数据 


LINQ 与 动态 类 型 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。LINQ 中 常见 的 扩展 方法 ; 
。 LINQ 语法 ; 


7.1 常见 的 扩展 方法 


实例 208 ” 求 最 大 值 与 最 小 值 

【导语 】 

使 用 Max 与 Min 两 个 扩展 方法 ,可 以 分 别 筛选 出 原 序列 中 的 最 大 值 与 最 小 值 。 这 两 
个 方法 的 应 用 目标 是 实现 了 IEnumerable< 工 > 的 对 象 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 

using SYstem. Ling; 

步骤 3: 初始 化 一 个 int 数组 。 

int[] arrsrc = { 100, 58, 8, 91, 560, 27, 42 }; 

步骤 4: 分 别 调用 Max 和 Min 方法 求 得 最 大 值 与 最 小 值 。 

// 求 最 大 值 


int max = arrsrc.Max(); 
// 求 最 小 值 


int min = arrsrc.Min(); 
步骤 5: 向 控制 台 输 出 求 得 的 最 大 值 与 最 小 值 。 


Console. WriteLine(" 原 数组 元 素 :{0}"， string.Join("、", arrsrc)); 
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Console. WriteLine(" 其 中 ,最 大 值 为 :{0}, 最 小 值 为 :{1}"，max， min); 
步骤 6: 运行 应 用 程序 ,输出 结果 如 下 。 


原 数 组 元 素 :100、58、8、91、560、27、42 
其 中 ,最 大 值 为 :560, 最 小 值 为 :8 


实例 209 求 工序 列表 中 最 长 的 加 工 周 期 


【导语 】 

Enumerable 的 许多 扩展 方法 都 带 有 一 个 Func<T, TResult > 委托 类 型 的 参数 ,可 以 通 
过 这 个 委托 参数 来 返回 要 进行 计算 的 目标 值 。 当 扩展 方法 被 调用 时 ,会 将 Enumerable 对 
象 中 的 每 个 元 素 都 传递 给 这 个 委托 , 即 每 访问 一 个 元 素 , 就 会 调用 一 次 该 委托 。 

本 实例 声明 一 个 Workltem 类 , 它 表 示 一 道 与 工序 相关 的 信息 ,其 中 包含 工序 的 开始 时 
间 StartTime, 以 及 工序 的 结束 时 间 EndTime。 如 果 要 计算 一 个 工序 序列 中 最 长 的 加 工 周 
期 ,就 需要 使 用 Func < 本 TResult > 委托 返回 EndTime 减 去 StartTime 的 结果 ,最 后 交 给 
Max 方法 去 筛选 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Ling; 
using System. Collections. Generic; 


步骤 3: 声明 WorkItem 类 。 


public class WorkItem 
{ 
/// < summary> 
/// 工序 序号 
/// </summary> 
public int ID { get; set; } 
/// < summary> 
/// 工序 描述 
/// </summary> 
public string Desc { get; set; } 
/// < summary> 
/// 开始 时 间 
/// </summary> 
public DateTime StartTime { get; set; } 
/// < summary> 
/// 结束 时 间 
/// </summary> 
public DateTime EndTime { get; set; } 
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步骤 4: 在 Main 方法 中 实例 化 一 个 List 对 象 ,并 向 其 中 添加 5 个 WorkItem 对 象 , 详 见 
代码 清单 7-1。 
代码 清单 7-1 向 List 中 添加 WorkItem 对 象 


List < WorkItem > works = new List< WorkItem>(); 
works. Rdd(new WorkItem 
{ 
D= 1, 
Desc = "工序 Ra"， 
StartTime = new DateTime(2018, 5, 10, 8, 32, 16), 
EndTime = new DateTime(2018, 5, 13, 14, 20, 0) 
]) 
works, Rdd(new WorkItem 
{ 
ID=2, 
Desc = "工序 B"， 
StartTime = new DateTime(2018, 5, 12, 7, 26, 15), 
EndTime = new DateTime(2018, 5, 12, 18, 24, 15) 
D); 
works, Add( new WorkItem 
{ 
De=3 
Desc = "工序 c"， 
StartTime = new DateTime(2018, 5, 17, 9, 45, 0), 
EndTime = new DateTime(2018, 5, 19, 20, 36, 4) 
D); 
works. Add( new WorkItem 
{ 
ID= 4, 
Desc = "工序 D"， 
StartTime = new DateTime(2018, 6, 1, 11, 0, 0), 
EndTime = new DateTime(2018, 6, 4, 16, 34, 0) 
DD); 
works. Add( new WorkItem 
{ 
ID = 5， 
Desc = "工序 E"， 
StartTime = new DateTime(2018, 7, 3, 7, 49, 0), 
EndTime = new DateTime(2018, 7, 5, 18, 17, 0) 
DD); 


步骤 5: 求 得 最 大 加 工 周期 ,并 输出 。 


Var max = works.Max(w => W.EndTime 一 w.StartTime); 


Console. WriteLine(" 最 长 加 工 周期 为 :{0: %d} 天 {0:%h} 时 {0:%m} 分 {0: % s} 秒 "，max); 
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步骤 6: 运行 应 用 程序 ,控制 台 输出 内 容 如 下 。 
最 长 加 工 周期 为 : 3 天 5 时 47 分 44 秒 


实例 210 ”计算 字符 串 的 总 长 度 


【导语 】 

本 实例 将 通过 Sum 方法 计算 一 个 字符 串 数组 中 所 有 字符 串 的 长 度 总 和 。Sum 方法 所 
返回 的 类 型 一 般 为 数值 ,如 int、double、decimal、long ,float 等。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Ling; 
步骤 3: 声明 并 初始 化 字符 串 数组 。 


string[ ] arr = 
{ 

"effect", "teach", "table", "purpose", "transport" 
}; 


步骤 4: 计算 数组 中 所 有 字符 串 的 总 长 度 。 


int len = arr.Sum(x => x.Length); 
Console. WriteLine( $ "字符 串 总 长 度 :{len}j"); 


步骤 5: 运行 应 用 程序 ,控制 台 输出 内 容 如 下 。 


字符 中 总 长 度 : 32 
实例 211 合并 两 个 序列 
【导语 】 


Concat 扩展 方法 支持 将 当前 序列 与 方法 参数 中 另 一 个 指定 的 序列 进行 合并 ,最 后 返回 
一 个 新 的 序列 一 一 新 序列 中 包含 二 者 的 所 有 元 素 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 两 个 List 实例 ,并 分 别 填充 元 素 。 


List< int> listl = newList< int> 


{ 


0 六 
}; 


List<int> list2 = new List< int> 


{ 
23，24 


}; 
步骤 3: 将 以 上 两 个 列表 进行 合并 ,然后 输出 合并 后 新 列表 的 元 素 。 


var result = listl.Concat(list2); 
Console. WriteLine(" 合 并 后 的 列表 :"); 
Console. WriteLine( string. Join('\', result)); 


步骤 4: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 


合并 后 的 列表 : 

20、21、.22、.23、24 

实例 212 有 多 少 个 矩形 的 面积 超过 100cm 
【导语 】 


扩展 方法 Count 可 用 于 计算 序列 中 元 素 的 个 数 ,并 且 可 以 根据 指定 的 条 件 进行 统计 。 
通过 Func< TSource，bool > 委托 来 给 定 统计 条 件 ,该 委托 的 输入 参数 为 原 序 列 中 的 元 素 实 
例 ,返回 值 为 一 个 布尔 值 , 即 如 果 给 定 的 元 素 符合 统计 要 求 就 返回 true, 不 符合 就 返回 
false。 

本 实例 用 一 个 Rectangle 结构 来 表示 和 矩形 数据 ,包含 Width 和 Height 两 个 字段 。 然 后 
产生 一 个 矩形 序列 ,调用 Count 扩展 方法 来 统计 面积 大 于 100cm? 的 和 矩形 数量 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
using System. Ling; 


步骤 3: 声明 Rectangle 结构 ,其 中 Width 字段 表示 宽度 ,Height 字段 表示 高 度 ,单位 都 
是 cm。 


public struct Rectangle 
{ 
public float Width; 
public float Height; 
} 


步骤 4: 在 Main 方法 中 初始 化 Rectangle 数组 。 


Rectangle[ ] rects = 
new Rectangle{ Width = 16.002f, Height = 7f }， 
new Rectangle{ Width = 2.5f, Height = 4.74f }, 
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new Rectangle { Width = 1.5f, Height = 3.5f }, 
new Rectangle{ Width = 6.9f, Height = 12.3f }, 
new Rectangle{ Width = 0.8f, Height = 10.22f }, 
new Rectangle{ Width = 9.4f, Height 21.3E 款 
new Rectangle{ Width = 6.5f，Height 32.8f } 


注意 : 在 数值 常量 后 面 加 上 f, 表 示 一 个 单 精度 数值 。 


步骤 5: 求 得 面积 大 于 100cm? 的 矩形 个 数 。 

int count = rects.Count(r => (r.Width * r.Height) > 100f); 
步骤 6: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 

面积 大 于 100 平方 厘米 的 矩形 有 3 个 


实例 213 ” 按 员工 年 龄 进行 降序 排列 


【导语 】 

本 实例 运用 OrderByDescending 扩展 方法 对 一 个 表示 员工 信息 序列 中 的 元 素 进 行 降序 
排列 , 即 按照 员工 年 龄 从 大 到 小 排序 。 

调用 OrderByDescending 方法 后 返回 的 对 象 类 型 为 IOrderedEnumerable < TElement > 接 
口 , 开 发 人 员 在 编写 代码 时 不 必 关 心 哪 些 类 型 实现 了 该 接口 ,因为 框架 内 部 已 经 封装 好 。 该 接 
口 继承 了 IEnumerable 接口 ,因此 支持 使 用 foreach 循环 访问 序列 中 的 元 素 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
using System. Ling; 


步骤 3: 定义 一 个 Employee 类 ,假设 它 封装 了 员工 的 基本 信息 。 


public class Employee 
. 
/// < summary> 
/// 员工 编号 
/// </summary> 
public int Eid { get; set; } 
/// < summary> 
/// 员工 姓名 
/// </summary> 
public string Ename { get; set; } 
/// < summary> 
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/// 员工 年 龄 

/// </summary> 

public int Eage { get; set; } 
} 


步骤 4: 在 Main 方法 内 部 创建 一 个 以 Employee 为 元 素 类 型 的 List 实例 ,并 且 进 行 初 
始 化 。 


List <Employee> emps = new List < Employee> 
{ 

new Employee { Eid = 1, Ename = " 老 高 ", Eage = 28 }, 
，Ename = " 老 刘 "，Eage = 42 }， 
， Ename = " 老 张 "，Eage = 27 }， 
Eage = 45 }, 
，Ename = " 老 陈 "，Eage = 36 }， 
，Ename = " 老 姜 ", Fage = 46 }， 
，Ename = " 老 徐 "，Eage = 51 } 


new Employee { Eid = 
new Employee { Eid = 
new Employee { Eid = 


new Employee { Eid = 

new Employee { Eid = 

new Employee { Eid = 
}; 


步骤 5: 调用 OrderByDescending 方法 ,按照 员工 年 龄 进行 降序 排列 。 
var result = emps.OrderByDescending(e => e.Eage); 

步骤 6: 输出 排序 后 的 员工 序列 。 

Console. WriteLine(" 将 员工 年 龄 按 降序 排列 :"); 


foreach (Employee emp in result) 


{ 
Console. WriteLine( $ "员工 编号 :{emp. Eid}, 员 工 姓名 :{emp. Ename}, 员工 年 龄 :{emp. Eage}"); 
} 


步骤 7: 运行 应 用 程序 项 目 ,控制 台 输 出 的 信息 如 图 7-1 所 示 。 


Ci\Program Files\dotnet\dotnet.exe 一 口 x 


图 7-1 按 员 工 年 龄 降序 排列 


实例 214 ”去掉 重 复 的 元 素 


【导语 】 
本 实例 通过 使 用 Distinct 扩展 方法 ,去 除 int 数组 中 的 重复 元 素 。Distinct 方法 处 理 完 
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后 会 返回 新 的 序列 ,新 序列 中 不 包含 重复 的 元 素 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 初始 化 一 个 int 数组 ,其 中 包含 重复 的 元 素 。 


Tv 150 150y 327 357 99; 35 bs 


步骤 3: 去 除 重复 的 元 素 。 


IEnumerable< int > result = arr.Distinct(); 
步骤 4: 输出 前 后 两 个 序列 中 的 元 素 , 以 便 对 比 。 


Console, WriteLine(" 原 序列 元 素 :{0}"， string. Join('、', arr)); 
Console. WriteLine(" 去 除 重 复元 素 后 :{0}"，string.Join('、，result) ); 


步骤 5: 运行 应 用 程序 ,输出 内 容 如 图 7-2 所 示 。 


\Program Files\domet\dotnetexe 一 0 x 


图 7-2 去 除 重复 的 元 素 


实例 215 ”筛选 出 两 个 序列 中 的 差异 元 素 


【导语 】 

当 序 列 A 调用 Except 扩展 方法 并 将 序列 B 作为 参数 传递 时 ,该 方法 将 筛选 出 序列 A 
中 与 序列 B 不 相同 的 元 素 ; 相反 地 ,如 果 序 列 B 调用 Except 扩展 方法 并 将 序列 A 传递 给 
方法 的 参数 ,那么 该 方法 将 筛选 出 序列 B 中 与 序列 A 不 相同 的 元 素 。 调 用 方法 后 得 到 的 返 
回 值 是 一 个 新 的 序列 ,里 面包 含 了 有 差异 的 元 素 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using Systenm. Ling; 
using System. Collections. Generic; 


步骤 3: 初始 化 两 个 uint 数组 。 


uint[] listl = {1, 2, 3, 4, 5, 6]; 
Wintf] list2 = {1, 2, 7; W 8 6 


步骤 4: 分 别 调用 两 个 数组 实例 的 Except 扩展 方法 ,得 到 当前 数组 与 男 一 数组 之 间 的 
差异 集 。 
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IEnumerable< uint > result1l 
IEnumerable< uint > result2 


list1. Except (list2); 
list2. Except (list1); 


步骤 5: 输出 两 个 差异 集中 的 元 素 。 


Console. WriteLine(" 序 列 1:{0}",， string.Join('', list1)); 
Console. WriteLine( "序列 2:{0}",， string.Join('', list2)); 
Console. WriteLine(" 序 列 1 中 与 序列 2 不 同 的 元 素 :{0}"，string. Join('', result1)); 
Console. WriteLine(" 序 列 2 中 与 序列 1 不 同 的 元 素 :{0}"， string.Join('', result2)); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 7-3 所 示 。 


图 7-3 两 个 数组 中 元 素 的 差异 


两 个 数组 中 存在 的 差异 元 素 有 3、5、7、8, 对 listl 数组 而 言 , 它 与 list2 数组 的 差异 元 素 
是 3 和 5; 对 list2 数组 而 言 , 它 与 listl 数组 的 差异 元 素 是 7 和 8。 


实例 216 “处理 First 方法 抛 出 的 异常 


【导语 】 

First 方法 的 作用 是 从 序列 中 取出 第 一 个 元 素 , 但 是 如 果 序列 是 空 的 ,调用 First 方法 就 
会 发 生 异常 。 解 决 方案 有 以 下 两 种 : 第 一 种 方案 是 将 调用 First 方法 的 代码 写 在 try…catch 
语句 块 中 , 显 式 捕捉 可 能 发 生 的 异常 ; 第 二 种 方案 是 调用 另 一 个 与 First 功能 相似 的 扩展 方 
法 一 一 FirstOrDefault, 这 个 方法 的 功能 也 是 从 序列 中 取出 第 一 个 元 素 ,但 是 如 果 序 列 是 空 
的 ,就 会 返回 元 素 类 型 的 默认 值 。 例 如 ,如 果 元 素 类 型 是 int, 当 获取 不 到 元 素 时 ,方法 就 返 
回 0。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
using System. Ling; 


步骤 3: 产生 一 个 空白 序列 ,元 素 类 型 为 long。 
IEnumerable< long> empty = Enumerable. Empty< long>(); 


创建 一 个 空白 序列 的 方法 很 简单 ,直接 调用 Enumerable 类 的 静态 方法 Empty 即 可 。 
步骤 4: 尝试 调用 First 方法 获取 序列 中 的 第 一 个 元 素 。 
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try 


{ 


} 


long x = empty.First(); 
Console. WriteLine(" 第 一 个 元 素 :{0}"，x); 


catch( Exception ex) 


{ 


} 


Console. WriteLine( $ "错误 :{ex. Message}"); 


由 于 序列 中 不 存在 元 素 ,调用 First 方法 就 会 发 生 异常 ,推荐 的 做 法 是 把 代码 写 在 try… 


catch 


语句 块 中 。 当 以 上 代码 被 执行 时 ,控制 台 会 输出 以 下 错误 信息 。 


错误 : Sequence contains no elements 


步骤 5: 通过 FirstOrDefault 方法 获取 序列 中 的 第 一 个 元 素 。 


long Y = empty.FirstOrDefault(); 
Console. WriteLine(" 第 一 个 元 素 :{0}"，yY); 


由 于 序列 为 空 ,无 法 获取 第 一 个 元 素 , 但 会 返回 long 类 型 的 默认 值 0, 因 此 控制 台 输出 
以 下 信息 。 


第 一 个 元 素 : 0 


实例 217 ” 当 序列 中 有 且 仅 有 一 个 元 素 时 


导语 】 


当 一 个 序列 中 有 且 仅 有 一 个 元 素 时 ,可 以 调用 Single 扩展 方法 来 返回 这 个 元 素 , 当 然 
也 可 以 用 First 方法 来 返回 。Single 方法 与 First 方法 最 明显 的 区 别 是 : Single 方法 只 有 在 


序列 
可 用 。 


P 仅 有 一 个 元 素 时 候 有 效 ; 而 First 方法 是 不 管 序列 中 有 多 少 个 元 素 , 只 要 存在 元 素 就 


如 果 序 列 为 空 或 者 元 素数 量 不 为 1, 调 用 Single 扩展 方法 会 抛 出 异常 ,也 可 以 调用 
SingleOrDefault 方法 来 避免 抛 出 异常 。 当 发 生 异 常 时 ,方法 将 返回 元 素 类 型 的 默认 值 。 


操作 流程 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 引入 以 下 命名 空间 。 


ui 


u: 


sing System. Collections. Generic; 
Sing System. Ling; 


步骤 3: 初始 化 一 个 List 实例 ,元素 类 型 为 int, 并 且 列 表 中 只 有 一 个 元 素 。 


LI: 


ist< int> list = new List<int>{ 15}; 


步骤 4: 调用 Single 方法 .获取 单个 元 素 。 
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int x = list.Single(); 


步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 


唯一 的 元 素 :15 
实例 218 ”筛选 出 手机 号 以 135 或 136 开头 的 联系 人 信息 
【导语 】 


Where 扩展 方法 可 用 于 从 序列 中 筛选 出 符合 条 件 的 元 素 ,组 成 新 的 序列 ,并 返回 给 调 
用 方 。 

本 实例 将 通过 Where 方法 从 联系 人 集合 中 筛选 出 手机 号 码 以 135 或 136 开头 的 联系 
人 对 象 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
using System. Ling; 


步骤 3: 声明 一 个 新 类 ,用 来 封装 与 联系 人 相关 的 信息 。 


public class Contact 
{ 
public int ContactID { get; set; } 
public string ContactName { get; set; } 
public string ContactEmail { get; set; } 
public string ContactPhoneNo { get; set; } 
} 


步骤 4: 在 Main 方法 中 声明 一 个 Contact 类 型 的 数组 ,并 填充 元 素 , 详 见 代码 清单 7-2。 
代码 清单 7-2 ”初始 化 Contact 数组 


Contact[ ] contacts = 
{ 
new Contact 
{ 
ContactID = 6501, 
ContactName = "小 何 "， 
ContactEmail = "abc@test.org"， 
ContactPhoneNo = "13578921100" 
}, 
new Contact 


{ 
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ContactID = 6502, 
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ContactName = "小石"， 
ContactEmail = "dede@sample.net", 
ContactPhoneNo = "13498016676" 
}, 
new Contact 
{ 
ContactID = 6503, 
ContactName = "小 陈 "， 
ContactEmail = "tisst@126.com", 
ContactPhoneNo = "13655614578" 
}， 
new Contact 
{ 
ContactID = 6504, 
ContactName = "小 黄 "， 
ContactEmail = "acc@163.com"， 
ContactPhoneNo = "13521347309" 
}, 
new Contact 
{ 
ContactID = 6505, 
ContactName =“" 小 李 "， 
ContactEmail = "ckh(@126. net", 
ContactPhoneNo = "13340090078" 
}, 
new Contact 
{ 
ContactID = 6506, 
ContactName =“" 小 刘 "， 
ContactEmail = "fl89@nt.cn", 
ContactPhoneNo = "15882133255" 


}; 


步骤 5: 调用 Where 方法 ,对 联系 人 序列 进行 筛选 。 


var result 
StartsWith("136")); 


contacts. Where(c = > c. ContactPhoneNo. StartsWith("135") | | c. ContactPhoneNo. 


步骤 6: 将 筛选 结果 输出 到 控制 台 。 


Console. WriteLine(" 手 机 号 以 135 
foreach(Contact ct in result) 
{ 


Console. WriteLine( $"\n 联 系 人 编号 :{ct. ContactID}\n 联系 人 名 称 :{ct. ContactName} \n 联 


或 136 开头 的 联系 人 有 :"); 
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系 人 电邮 :{ct.ContactEmail}\n 联系 人 手机 号 :{ct. ContactPhoneNo}"); 
} 


步骤 7: 运行 应 用 程序 ,输出 结果 如 图 7-4 所 示 。 


Ci\Program Files\dotnet\d. — 口 x 


7-4 筛选 后 的 联系 人 序列 


实例 219 将 对 象 转换 为 字典 集合 


【导语 】 

ToDictionary 扩展 方法 比较 有 趣 , 它 可 以 将 序列 中 的 每 个 元 素 转换 为 Key-Value 对 , 然 
后 组 成 一 个 字典 集合 。 

本 实例 用 到 以 下 重 载 版 本 。 

Dictionary < TKey, TElement > ToDictionary < TSource, TKey, TElement > (this IEnumerable < TSource > 

source, Func < TSource, TKey> keySelector, Func < TSource, TElement > elementSelector); 

其 中 ,keySelector 参数 与 elementSelector 参数 都 是 委托 类 型 ,分 别 用 于 返回 作为 字典 
中 元 素 的 Key 和 Value。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
using System. Ling; 


步骤 3: 声明 一 个 类 , 它 表示 一 件 产 品 的 基础 信息 。 


public class Production 


{ 
/// < summary> 


/// 产品 编号 
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/// </summary> 

public int PID { get; set; } 

/// < summary> 

/// 产品 名 称 

/// </summary> 

public string Name { get; set; } 

/// < summary> 

// 产品 尺寸 

/// </summary> 

public float Size { get; set; } 

/// < summary> 

/// 生产 数量 

/// </summary> 

public int Quantity { get; set; } 
} 


步骤 4: 在 Main 方法 中 声明 一 个 Production 数组 ,并 进行 实例 化 。 


Production[ ] prds = 
{ 


new Production 

{ 
PID = 4007, 
Name = "产品 1"， 
Size = 123.45f, 
Quantity = 65 

}, 

new Production 

{ 
PID = 4008, 
Name = "产品 2"， 
Size = 77.01f, 
Quantity = 100 

}, 

new Production 

{ 
PID = 4012, 
Name = "产品 3"， 
Size = 45;13£; 
Quantity = 25 


}; 


步骤 5: 调用 ToDictionary 方法 将 数组 中 的 Production 元 素 转换 为 字典 结构 的 数据 。 
其 中 ,PID 属性 将 作为 字典 的 Key,Name 属性 将 作为 字典 的 Value。 


IDictionary< int, string> dic = prds.ToDictionary(p => p.PID, p => p. Name); 
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步骤 6: 输出 新 生成 的 字典 集合 中 的 元 素 信息 。 
Console. WriteLine(" 转 换 得 到 的 字典 数据 :"); 


foreach(var kp in dic) 
{ 

Console. WriteLine("{0} — {1}", kp. Key, kp. Value); 
F 


步骤 7: 运行 应 用 程序 ,输出 结果 如 图 7-5 所 示 。 
实例 220 ”将 原始 序列 进行 分 组 


【导语 】 
要 将 原始 序列 中 的 元 素 进行 分 组 ,可 以 调用 GroupBy 扩展 方法 。 此 
本 ,本 实例 使 用 了 以 下 重 载 的 形式 。 


5 


IEnumerable < TResult > GroupBY < TSource, TKey, TResult >(this IEnumerabl 


生成 的 字典 数据 


方法 有 多 个 重 载 版 


e< TSource > source, 


Func < TSource, TKey > keySelector, Func < TKey, IEnumerable < TSource >, TResult > 


resultSelector); 


其 中 有 三 个 类 型 参数 : TSource 是 原始 序列 中 的 元 素 ,TKey 是 分 组 依据 (例如 按 某 对 
象 的 Age 属性 进行 分 组 ,那么 TKey 就 是 Age 属性 的 类 型 ) ,TResult 是 返回 给 调用 方 的 已 


分 组 序列 中 的 元 素 类 型 。 

keySelector 委托 用 于 产生 分 组 依据 , resultSelector 委托 则 用 了 
resultSelector 委托 有 两 个 输入 参数 : 第 一 个 参数 是 分 组 依据 , 即 该 分 组 
参数 是 隶属 该 分 组 下 的 元 素 所 组 成 的 子 序列 。 


FF 产生 分 组 结果 
的 “标题 ”; 第 二 个 


在 本 实例 中 ,Student 类 表示 学 员 信息 ,代码 将 对 学 员 列 表 中 的 对 象 按照 他 们 各 自 所 参 


与 的 课程 分 组 ,例如 ,参与 学 习 C++ 语言 的 学 员 便 构成 一 个 分 组 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 引入 以 下 命名 空间 。 


using Systenm. Ling; 
using System. Text; 


步骤 3: 声明 Student 类 ,表示 学 员 信息 。 


public class Student 

{ 
public int ID { get; set; } 
public string Name { get; set; } 
public string Course { get; set; } 

} 


步骤 4: 在 Main 方法 中 实例 化 一 个 Student 数组 并 填充 一 些 示 例 元 素 。 


详 见 代 码 清单 7-3。 
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代码 清单 7-3 用 于 示例 的 Student 数组 


Student[ ] stus = 
{ 


new Student 

{ 
ID = 201, 
Name = "小 王 "， 
Course = 


}， 


new Student 


{ 


}, 


new Student 


{ 
ID = 203, 
Name = "小 昌 "， 
Course = "C++" 

}, 

new Student 

{ 
ID = 204, 
Name =“" 小 孙 "， 
Course = "C#" 

}, 

new Student 

{ 
ID = 205, 
Name = "小 郑 "， 
Course = "C" 

}, 

new Student 

{ 
ID = 206, 
Name = "小 叶 "， 
Course = "C" 

}, 

new Student 

{ 
ID = 207, 
Nane = "小 苏 "， 
Course = "C#" 

}, 

new Student 

出 
ID = 208, 
Name =“" 小 梁 "， 
Course = "Delphi" 


}; 


第 7 章 ， LINO 与 动态 类 型 | 其 265 


步骤 5: 调用 GroupBy 方法 ,按照 学 员 所 参与 的 课程 进行 分 组 。 


var result = stus. GroupBY(s = > s.Course, (gKey, gItems) = > (GroupKey: gKey, ItemCount: 
gItems. Count(), Items: gItems)); 


调用 以 上 方法 后 ,产生 的 结果 类 型 是 三 元 组 序列 ,其 中 GroupKey 字段 表示 分 组 标题 ， 


ItemCount 字段 表示 该 分 组 下 学 员 数 量 ,Items 字段 表示 属于 该 分 组 的 学 员 列表 。 


Wr 


天 


步骤 6: 输出 分 组 后 的 序列 信息 。 


Console. WriteLine(" 学 员 参 与 课程 汇总 :"); 

StringBuilder strbuilder = new StringBuilder(); 

foreach(var g in result) 
strbuilder. AppendFormat(" 课 程 :{0}\n"，g. GroupKey); 
strbuilder. ARppendFormat(" 参与 人 数 :{0}\n"，g. ItemCount); 
strbuilder,. AppendLine(" 名 单 :"); 
foreach (Student s in g, Items) 
{ 

strbuilder. AppendFormat(" {0} — {1}\n", s.ID, s.Name); 

} 

} 


Console. WriteLine( strbuilder); 

以 上 代码 使 用 了 StringBuilder 类 来 组 装 字符 串 , 再 通过 
iteLine 方法 进行 输出 。 图 7-6 分 组 后 的 学 员 信息 

步骤 7: 运行 应 用 程序 ,输出 结果 如 图 7-6 所 示 。 


2 LINO 语法 


实例 221 ”筛选 能 被 5 整除 的 整数 


【导语 】 
LINQ 语句 以 from 子 句 开头 ,以 select 子 句 结尾 ,这 两 个 子 句 是 必要 元 素 。 在 from 子 


名 与 select 子 句 之 间 , 可 以 使 用 其 他 辅助 查询 的 子 句 ,如 where、orderby、group 等 。 在 使 用 
LINQ 语法 的 代码 中 ,需要 引入 System. Linq 命名 空间 。 


询 吕 


要 从 序列 中 筛选 出 符合 条 件 的 元 素 ,应 当 在 select 子 句 之 前 使 用 where 子 句 。 一 个 查 


可 以 包含 多 个 where 子 句 ,而 且 where 子 句 后 面 可 以 跟随 多 个 表达 式 ,表达 式 的 计算 


结果 必须 为 布尔 值 。 


本 实例 将 演示 使 用 LINQ 语法 从 一 个 整数 序列 中 筛选 出 能 被 5 整除 的 元 素 , 即 与 5 进 


行 模 运 算 后 结果 为 0 的 元 素 。 


【操作 流程 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
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步骤 2: 初始 化 一 个 int 类 型 的 数组 。 
int[] arr = { 12, 15, 35, 32, 45, 77, 80, 63 }; 
步骤 3: 使 用 LINQ 语句 筛选 出 能 被 5 整除 的 元 素 。 


var res = fromn in arr 
where (n % 5) == 0 
select ni; 


步骤 4: 输出 筛选 后 的 元 素 。 
Console. WriteLine(" 能 被 5 整除 的 元 素 有 :"); 


foreach(int x in res) 


{ 


Console. Write(" {0}", x); 图 7-7 能 被 5 整除 的 元 素 
E 


步骤 5: 运行 应 用 程序 ,输出 结果 如 图 7-7 所 示 。 

实例 222” 求 序列 中 元 素 的 平方 根 并 按 降序 排列 

【导语 】 

本 实例 中 查询 语句 的 处 理 有 两 个 步骤 : 首先 求 得 元 素 的 平方 根 ,实现 方法 是 调用 Math 
类 的 Sqrt 方法 ; 然后 将 计算 结果 降序 排列 ,如 果 要 在 LINQ 语句 中 进行 排序 ,就 需要 在 
select 子 句 之 前 使 用 orderby 子 句 。 

orderby 子 句 用 法 如 下 。 


orderby < 排序 对 象 > ascending | descending 


ascending 关键 字 表 示 升 序 排列 ,此 为 默认 排序 方式 ,因此 如 果 要 按 升序 排列 ,可 以 省 略 
ascending 关键 字 。descending 关键 字 表 示 降 序 排列 ,由 于 降序 并 非 默认 排序 方式 ,所 以 不 
能 省 略 descending 关键 字 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 并 初始 化 一 个 double 数组 。 

double[ ] srcs = 

{ 


17.5d, 42.33d, 100d, 130d, 256d, 312.14d, 96.656d 
}; 


步骤 3: 使 用 LINQ 语句 将 数组 中 元 素 的 平方 根 进行 降序 排列 。 


var q = from x in srcs 
let s = Math.Sart(x) 
orderby s descending 
Select (x, s); 
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let 关键 字 可 以 在 查询 语句 内 部 声明 一 个 临时 变量 ,此 处 使 用 临时 变量 s 来 保存 元 素 x 
的 平方 根 计算 结果 。select 子 句 产生 一 个 二 元 组 ,其 中 第 一 个 字段 是 元 素 x, 第 二 个 字段 是 
计算 结果 s( 临 时 变量 ) 。 

步骤 4: 输出 查询 结果 。 


foreach (var n in q) 


{ 
Console. WriteLine("{0, -10} -> {1, — 16}", n.x, 
n.s); 


} 
步骤 5: 运行 应 用 程序 ,输出 内 容 如 图 7-8 所 示 。 ”” 图 7-8 按 元 素 的 平方 根 降序 排列 


实例 223 ”select 子 句 返回 的 内 容 


【导语 】 

执行 LINQ 语句 查询 后 所 返回 的 元 素 类 型 取决 于 select 子 句 , 即 该 子 句 后 面 的 表达 式 
所 产生 的 结果 。 为 了 提高 查询 代码 的 灵活 性 ,一 般 不 建议 专门 为 查询 结果 定义 新 类 型 ,因为 
查询 语句 产生 的 结果 多 数 情况 下 是 动态 的 。 

本 书 推荐 使 用 以 下 两 种 返回 类 型 ; 

(1) 最 为 经 典 的 做 法 一 一 返回 匿名 类 型 。 匿 名 类 型 的 类 型 名 称 由 编译 器 自动 分 配 ,在 
编写 代码 期 间 , 开 发 人 员 是 无 法 得 知 其 类 型 名 称 的 。 只 需要 使 用 new 运算 符 对 匿名 类 型 进 
行 类 型 实例 化 ,并 对 类 型 属性 赋值 即 可 。 

(2) 可 以 考虑 返回 元 组 ,并 且 可 以 将 元 组 中 的 字段 重 命名 为 有 意义 的 、 易 识别 的 名 称 。 
如 果 查 询 结 果 用 于 方法 返回 值 ,select 子 句 返回 元 组 是 比较 合理 的 ,因为 匿名 类 型 是 动态 生 
成 的 类 型 名 称 ,在 方法 的 返回 值 上 无 法 固定 类 型 名 。 过 去 的 做 法 是 将 方法 的 返回 类 型 设 定 
为 动态 类 型 (Dynamic) ,然后 把 查询 结果 赋值 给 动态 类 型 ,但 这 样 做 容易 输 错 代码 (访问 动 
态 类 型 没有 智能 提示 )。 但 结合 最 新 的 语言 特性 ,可 以 让 查询 返回 元 组 ,再 通过 方法 将 元 组 
返回 给 调用 方 ,这 种 做 法 可 以 弥补 匿名 类 型 不 能 确定 类 型 名 称 的 不 足 。 

本 实例 演示 了 LINQ 查询 的 三 种 返回 类 型 ,分 别 为 : 字符 串 .匿名 类 型 以 及 元 组 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 初始 化 一 个 日 期 /时 间 数 组 。 

DateTine[ ] dts = 


{ 


new DateTime(2016, 6, 12), 

new DateTime(2018, 4, 13), 

new DateTime(2001, 9, 21) 
}; 


步骤 3: 使 用 LINQ 查询 数组 中 的 日 期 ,并 以 短 日 期 字符 串 的 形式 返回 。 
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var ql = fromd in dts 
select d. ToShortDateString( ); 
步骤 4: 声明 一 个 自 定义 类 ,命名 为 Person。 


public class Person 


public int ID { get; set; } 
public string Name { get; set; } 
public int Age { get; set; } 


步骤 5: 实例 化 一 个 Person 类 型 的 数组 。 


Person[ ] parr = 


new Person{ ID = 1, Name = " 老 胡 ", age = 23 }， 
new Person{ ID = 2, Name = "老汉 ", age = 30 }， 
new Person{ ID = 3，Name =" 老 余 ", Rge = 31 } 


步骤 6: 通过 查询 返回 一 个 包含 匿名 类 型 的 结果 ,该 匿名 类 型 仅仅 引用 了 Person 对 象 
的 ID 和 Name 属性 的 内 容 。 
var q2 = from p in parr 


select new 
:| 
PersonID = p.1D, 
PersonName = p. Name, 
}; 


注意 : 初始 化 匿名 类 型 时 ,如 果 属 性 名 称 与 原 对 象 的 属性 名 称 相同 ,可 以 直接 引用 原 对 象 的 
属性 ; 否则 ,可 以 自 定义 新 的 属性 名 称 。 
步骤 7: 声明 一 个 字符 串 实 例 。 
string s = "abcdef"; 


步骤 8: 由 于 该 字符 串 是 由 char 序列 组 合 而 成 的 ,所 以 可 以 将 string 对 象 视 为 char 类 
型 元 素 的 序列 进行 查询 操作 。 


var q3 = fromc in s 
let index = s. IndexOf(c) 
select (Index: index, Char: c); 
在 查询 内 部 ,用 index 变量 临时 存放 字符 c 在 字符 串 s 中 的 索引 ,在 select 子 句 中 ,返回 
二 元 组 ,包含 Index 和 Char 两 个 字段 。 
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在 foreach 循环 中 ,可 以 直接 访问 元 组 的 字段 。 


foreach (var i in q3) 
{ 

Console. WriteLine( $ "{i. Index} — '{i.Char}""); 
} 


步骤 9: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 7-9 所 示 。 


Cprogramfiles\do.. 一 口 x 


图 7-9 用 select 子 句 确定 查询 所 返回 的 元 素 类 型 


实例 224 按 员 工 所 属 部 门 分 组 


【导语 】 

本 实例 假设 Employee 类 表示 某 公 司 的 员工 信息 ,其 中 , Name 属性 是 员工 姓名 ， 
Department 属性 是 员工 所 属 的 部 门 。 随 后 将 员工 信息 序列 按照 部 门 进行 分 组 。 

在 LINQ 查询 中 对 序列 进行 分 组 需要 用 到 group…by 子 句 ,group 关键 字 之 后 是 要 进 
行 分 组 的 对 象 ,by 关键 字 之 后 是 分 组 标题 , 即 依据 什么 进行 分 组 。 

分 组 后 会 返回 一 个 实现 了 IGrouping 接口 的 对 象 实例 ,该 接口 也 继承 了 IEnumerable 
接口 成 员 ,使 得 代码 支持 枚 举 此 分 组 下 的 元 素 , 同 时 又 带 有 一 个 Key 属性 , 即 分 组 标题 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 Employee 类。 


public class Employee 

{ 
public string Name { get; set; } 
public string Department { get; set; } 


270 | .NET Core 实战 一 -手把手 教 你 学 握 380 个 精彩 案例 


步骤 3: 初始 化 一 个 Employee 数组 。 


Employee[ ] emps = 

{ 
new Employee{ Name = "小 黄 "，Department = "财务 部 " }， 
new Employee{ Name = "小 卢 "，Department = "开发 部 " }， 
new Employee{ Name = "小 邢 "，Department = "开发 部 " }， 
new Employee{ Name = "小 陈 "，Department = "财务 部 " }， 
new Employee{ Name "小 卜 "，Department = "公关 部 " }， 
new Employee{ Name "小 罗 "，Department = "仓储 部 " }， 
new Employee{ Name = "小 许 "，Department = "开发 部 " }， 
new Employee{ Name = "小 田 "，Department = "仓储 部 " } 


}; 
步骤 4: 通过 LINQ 查询 ,将 员工 信息 序列 按 部 门 名 称 分 组 。 


var q = from e in emps 
group e by e. Department; 


步骤 5: 输出 分 组 后 的 序列 信息 。 


foreach (var g in q) 

{ 
Console. WriteLine("{0}:", g. Key); 
foreach (var emp in g) 


{ 

Console. WriteLine(" {0}", emp. Name); 
} 
Console. WriteLine( ); 


} 
第 一 层 循环 是 读 取 单 个 分 组 数据 ,第 二 层 循环 是 访问 该 分 组 下 所 


图 7-10 分 组 后 的 
包含 的 员工 信息 。 
员工 信息 
步骤 6: 运行 应 用 程序 ,输出 内 容 如 图 7-10 所 示 。 
实例 225 “内 联 " 查 询 
【导语 】 
使 用 join 子 句 可 以 将 当前 查询 的 序列 与 男 一 个 “有 关系 ”的 序列 联合 起 来 进行 分 析 , 语 
法 如 下 。 


from a in < 当前 序列 > 

join b in < 另 一 个 序列 > on a. id equals b. pid 

select… 

on 后 面 的 表达 式 是 两 个 序列 进行 关联 的 条 件 , 即 当前 序列 中 的 元 素 必 须 有 某 个 属性 值 
与 男 一 个 序列 中 元 素 的 某 个 属性 值 相 等 。 此 处 的 相等 判断 不 能 使 用 二 二 运算 符 ,应 当 使 用 
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equals 关键 字 , 这 是 LINQ 语法 中 联合 查询 专用 的 关键 字 。 

联合 查询 中 的 “内 联 ?模式 是 这 样 的 : 假如 有 两 个 序列 ,一 个 是 自行 车 列表 , 另 一 个 是 人 
员 列 表 。 每 辆 自行 车 都 有 它 的 主人 ,而 每 位 人 员 可 以 拥有 多 辆 自行 车 ,因此 人 与 自行 车 之 间 
形成 了 “一 对 多 ”的 关系 。 当 这 两 个 序列 进行 联合 查询 时 ,如 果 自 行车 序列 中 存在 与 人 员 序 
列 中 不 匹配 的 元 素 ,那么 这 个 元 素 (自行 车 ) 就 不 会 被 查询 出 来 ,因为 它 与 人 员 序 列 中 的 元 素 
(人 ) 没 有 对 应 关系 。 

本 实例 将 进行 这 样 的 演示 : 第 一 个 序列 为 课程 列表 ,第 二 个 序列 为 学 生 列 表 。 一 位 学 
生 可 以 选择 多 门 课程 ,同样 也 存在 有 些 课程 没有 学 生 选 择 的 情况 。 当 两 个 序列 联合 查询 时 ， 
没有 被 选择 的 课程 不 会 出 现在 查询 结果 中 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 Course 类 ,表示 课程 信息 。 


public class Course 


public int ID { get; set; } 
public string Name { get; set; } 


步骤 3: 声明 Student 类 ,表示 学 生 信 息 。 
public class Student 


public string Name { get; set; } 
public int CourseID { get; set; } 


步骤 4: 初始 化 课程 与 学 生 序列 。 


Course[ ] courses = 


new Course { ID = 301, Name = "HTML 5" }, 

new Course { ID = 302, Name = "C++" }, 

new Course { ID = 303, Name = "ASP. NET Core" }, 
new Course { ID = 304, Name = "PHP" }, 

new Course { ID = 305, Name = "Javascript” } 


}; 


Student[ ] students = 
{ 


new Student { Name = "小 季 "，CourseID = 304 }, 
new Student { Name = "小 吴 "，CourseID = 303 }, 
new Student { Name = "小 白 "，CourseID = 303 }, 
new Student { Name = "小 曹 "，CourseID = 302 }， 
new Student { Name = "小 解 "，CourseID = 302 } 
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步骤 5: 联合 查询 两 个 序列 。 


var qr = from s in students 
join c in courses on s. CourseID equals c. ID 
select (StudentName: s. Name，CourseName: c. Name); 
学 生 信息 中 的 CourseID 属性 与 课程 信息 中 ID 属性 关联 , 即 课程 编号 。 
步骤 6: 输出 查询 结果 。 


CProgra.. 一 


学 PHP 


foreach (var x in qr) 
{ 
Console. WriteLine ( $ " {x. StudentName} 选 了 《{x. 
CourseName} )"); 
} 


步骤 7: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 7-11 所 示 。 


图 7-11 学 生 选课 信息 查询 结果 


注意 : 由 于 课程 “HTML 5” 和 “Javascript” 没 有 被 选 ,在 学 生 序 列 中 没有 对 应 关系 ,因此 不 会 


出 现在 查询 结果 中 。 


实例 226 ”处 理 查询 中 的 异常 


【导语 】 
定义 LINQ 语句 后 并 不 是 马上 执行 ,而 是 仅 保存 查询 指令 , 当 查 询 结果 被 访问 时 ,查询 


才 会 真正 执行 。 因 此 ,如 果 要 处 理 LINQ 查询 中 可 能 发 生 的 异常 ,不 需要 把 LINQ 语句 放 在 
try…catch 代码 块 中 ,而 应 该 把 访问 查询 结果 的 代码 放 在 try…catch 代码 块 中 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 初始 化 一 个 int 数组 。 
int[ Tarrare 本 二 2 
步骤 3: 使 用 LINQ 语句 对 上 述 数组 进行 查询 ,在 select 子 句 中 将 元 素 值 除 以 0。 
var q = from x in arrsrc 
select x / 0; 
由 于 0 是 不 能 做 除数 的 ,上 述 代码 自然 是 错误 的 ,但 是 执行 上 述 代码 时 并 不 会 抛 出 异 
因为 查询 并 未 真正 执行 ,只 有 当 查 询 结果 被 访问 时 才 会 执行 。 
步骤 4: 使 用 foreach 语句 访问 查询 结果 ,此 时 ,代码 应 当 写 在 try…catch 代码 块 中 , 当 


生 异 常 时 可 以 进行 捕 提 。 


try 
{ 


foreach( int i in q) 
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{ 
Console. WriteLine(i); 

} 
} 
catch( Exception ex) 
{ 

Console. WriteLine( "错误 信息 :{0}"，ex. Message); 
} 


步骤 5: 运行 应 用 程序 ,得 到 的 结果 如 下 。 


错误 信息 : Attempted to divide by zero. 


实例 227 DefaultIfEempty 方法 的 作用 


【导语 】 
DefaultIfEmpty 方法 的 作用 是 : 当 某 个 序列 中 没有 元 素 时 ,将 返回 该 元 素 类 型 的 默认 
值 ,例如 以 下 序列 。 


List<int>1 = new List< int >(); 


此 时 ,列表 中 没有 元 素 , 调 用 以 下 代码 返回 一 个 只 有 单个 元 素 的 序列 ,其 中 包含 int 类 
型 的 默认 值 , 即 0。 


var e = 1.DefaultIfEmpty(); 


DefaultIfEmpty 方法 一 般 用 于 联合 查询 中 , 当 第 二 个 序列 中 不 存在 与 第 一 个 序列 匹配 
的 元 素 时 将 返回 元 素 的 默认 值 , 以 保证 第 一 个 序列 中 的 元 素 能 够 全 部 查询 出 来 , 即 “ 左 外 联 ” 
查询 。 

本 实例 将 定义 两 个 序列 : 一 个 是 订单 序列 (Order 类 表示 ) , 另 一 个 是 订单 详细 数据 序 
列 (OrderDetails 类 表示 ) ,而 Order 类 中 的 Details 属性 会 引用 一 个 关联 的 OrderDetails 实 
例 。 在 两 个 序列 联合 查询 时 ,一 旦 订单 详细 数据 序列 中 不 存在 与 Details 属性 匹配 (Details 
属性 为 null) 的 元 素 , 就 返回 一 个 固定 的 OrderDetails 实例 作为 默认 值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 OrderDetails 类 ,表示 订单 详细 信息 。 


public class OrderDetails 

{ 
public int Amount { get; set; } 
public decimal Price { get; set; } 
public string Code { get; set; } 

} 


步骤 3: 声明 Order 类 ,表示 订单 信息 ,其 中 Details 属性 引用 OrderDetails 实例 。 
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public class Order 


public int ID { get; set; } 

public DateTime Date { get; set; } 
public bool State { get; set; } 

public OrderDetails Details { get; set; } 


步骤 4: 实例 化 两 个 OrderDetails 对 象 。 


OrderDetails dl = new OrderDetails 


Amount = 10, 
Price = 2.5M, 
Code = "T—70770" 


OrderDetails d2 = new OrderDetails 


Amount = 12, 
Price = 3.2M, 
Code = "T—70778" 


步骤 5: 实例 化 三 个 Order 对 象 。 第 三 个 Order 实例 的 Details 属性 没有 引用 任何 
对 象 。 


Order ol = new Order 


{ 


Date = new DateTime(2018, 3, 1), 
State = true, 
Details = dl 

}; 

Order o2 = new Order 


{ 


Date = new DateTime(2018, 3, 13), 
State = false, 
Details = d2 

] 

Order o3 = new Order 


{ 


Date = new DateTime(2018, 3, 18), 
State = true, 
Details = null 

}; 
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步骤 6: 声明 两 个 List 集合 ,用 于 存放 以 上 对 象 。 


List <Order > orders = new List<Order> { ol, o2，o3 }; 
List <OrderDetails> details = new List <OrderDetails> { di, d2 }; 


步骤 7: 对 上 述 两 个 序列 进行 联合 查询 。 


var q = from o in orders 

join d in details on o.Details equals d intog 

from x in g.DefaultIfEmpty(new OrderDetails { Amount = 0, Price = 0.00M, Code = "未 
知 编码 ”}) 

select (OrderID: o. ID, Amout: x.Amount, Code: x.Code); 


当 没 有 匹配 项 时 ,产生 一 个 固定 的 OrderDetails 对 象 作为 默认 值 ,其 中 Amount 属性 为 


0,Price 属性 为 0. 00,Code 属性 为 “未 知 编码 ”。 
步骤 8: 输出 查询 结果 到 控制 台 。 


foreach (var i in q) 
{ 

Console, WriteLine("{0, -11}{1, - 10}{2, -20}", 
i.OrderID, i.Amout, i.Code); 


} 图 7-12 “ 左 外 ”联合 查询 的 结果 
步骤 9: 运行 应 用 程序 ,输出 结果 如 图 7-12 所 示 。 


实例 228 ”使 用 LINQ 将 序列 转换 为 XML 文档 


【导语 】 

本 实例 将 演示 如 何 通过 LINQ 查询 ,把 一 个 Account 类 型 的 序列 转换 为 XML 文档 。 
要 将 查询 结果 转换 为 XML 格式 ,关键 是 运用 select 子 句 。select 子 句 之 后 可 以 产生 一 个 
XElement 对 象 ,作为 XML 元 素 的 包装 ,在 XElement 内 还 可 以 嵌 套 子 元 素 或 者 使 用 
XAttribute 来 定义 XML 特性 。 

XML 文档 一 般 需 要 根 元 素 , 所 以 在 LINQ 查询 生成 XML 元 素 序 列 后 ,还 要 用 一 个 单 
独 的 XElement 实例 来 包装 ,以 作为 XML 文档 的 根 元 素 , 最 后 再 把 这 个 根 元 素 实例 传递 给 
XDocument 类 的 构造 函数 ,最 终 形成 一 个 完整 的 XML 文档 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Account 类 ,模拟 用 户 信 息 。 


public class Account 
{ 
/// < summary> 
/// 用 户 I 
/// </summary> 
public ;int UserID { get; set; } 
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/// < summary> 
/// 用 户 名 
/// </summary> 
public string UserName { get; set; } 
/// < summary> 
/// 用 户 密码 
/// </summary> 
public string Password { get; set; } 
/// < summary> 
/// 是 否 为 管理 员 
/// </summary> 
public bool IsAdmin { get; set; } 
} 


步骤 3: 在 Main 方法 中 实例 化 一 个 Account 数组 。 


Account[] accs = 


{ 


new Account 


{ 
UserID = 1, 
UserName = "user 1", 
Password = "123", 
IsAdnmin = false 

}, 

new Account 

{ 
UserID = 2, 
UserName = "user 2", 
Password = "678", 
IsAdmin = false 

}, 

new Account 

{ 


UserID = 3, 
UserName = "user 3", 
Password = "hjk", 
IsAdmin = true 


}; 
步骤 4: 使 用 LINQ 语句 查询 上 述 数组 中 的 所 有 元 素 并 产生 XElement 实例 。XML 元 


素 名称 为 account, 而 Account 实例 的 属性 分 别 对 应 着 user_id、user_name、password 和 is_ 
admin 四 个 XAttribute 实例 。 


Var elements = from a in accs 


select new XElement("account"， 


new XAttribute("user id", a.UserID), 

new XAttribute("user name", a.UserName), 
new XAttribute("password", a.Password), 
new XAttribute("is admin", a.IsAdmin)); 


步骤 5: 创建 文档 根 元 素 ,元素 名 称 为 accounts, 用 以 包装 上 述 代码 所 产生 的 XML 元 
素 序列 ,最 后 用 于 初始 化 XML 文档 。 

// 创建 文档 的 根 元 素 

XElement root = new XElement("accounts", elements); 


// 创建 文档 对 象 


XDocument doc = new XDocument(root); 


步骤 6: 运行 应 用 程序 ,转换 得 到 如 下 的 XML 文档 。 


< accounts > 
<account user_id= "1" user_name = "user 1" password= "123" is_admin = "false" /> 
<account user_id= "2" user name = "user 2" password= "678" is_admin = "false" /> 
<account user_id= "3" user name= "user 3" password= "hjk" is_admin = "true" /> 
</accounts> 


实例 229 ”将 分 组 后 的 序列 重新 排序 


【导语 】 
group 子 句 可 以 搭配 into 关键 字 , 和 暂时 存放 已 经 分 好 组 的 元 素 ,例如 : 


group x by x. Type into gs 


其 中 ,gs 就 是 保存 该 分 组 序列 的 临时 变量 名 。 
在 完成 对 数据 序列 的 分 组 后 ,可 以 通过 嵌 套 一 个 LINQ 查询 对 组 内 元 素 进行 重新 排序 ， 
例如 : 


from a in someList 
group a by a. Type into gk 
let q2 = (from b in gk orderby b select b) 
select new { Key = gk.Key, SubItems = q2 }; 
其 中 ,临时 变量 q2 所 引 有 的 就 是 一 个 嵌 套 的 LINQ 查询 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 初始 化 一 个 string 类 型 的 数组 。 


string[ ] arrsrc = 
{ 
"at", "act", "market", "fable", "also", "alt", "bee", "back", "book", "build", "face", 
"full", "fish", "food", "find", "meet", "make", "moo", "muklek" 
}; 
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步骤 3: 将 以 上 数组 中 的 单词 按 首 字母 进行 分 组 ,并 对 组 内 的 单词 重新 排序 。 


var q = from s in arrsrc 
group s by s[0].ToString().ToUpper() intog 
orderby g. Key 
let nq = (fromw ing 
orderby w 
select w) 


select (Key: g. Key, Items: nq); 
步骤 4: 输出 查询 结果 。 


foreach (var t in q) 


{ 
Console. WriteLine(t. Key); 
foreach (var sub in t. Items) 


{ 
Console, WriteLine(" {0}", sub); 


步骤 5: 运行 应 用 程序 ,输出 内 容 如 下 。 


also 
at 
back 


book 
build 


fable 
face 
find 
fish 
food 
full 


make 
market 
meet 
moo 
muklek 
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实例 230 ”将 字典 集合 转换 为 字符 串 序列 


【导语 】 

使 用 LINQ 语句 查询 字典 集合 ,可 以 通过 select 子 句 把 字典 集合 中 的 键 / 值 对 转换 为 字 
符 串 序列 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 一 个 字典 集合 , 稍 后 用 于 做 转换 。 


IDictionary< string, int > dic = new Dictionary< string, int> 


L 


["item 1"] = 342, 
["item 2"] = 700, 
["item 3"] = 800 


}; 
步骤 3: 使 用 LINQ 查询 将 字典 集合 转 为 字符 串 序列 。 


varq = fromp in dic 
select $"{p.Key} : {p.Value}"; 


步骤 4: 输出 转换 之 后 的 字符 串 序列 。 


foreach( string i in q) 


{ 


Console. WriteLine(i); 


} 图 7-13 ”从 字典 转换 而 来 的 字符 串 
步骤 5: 运行 应 用 程序 项 目 ,结果 如 图 7-13 所 示 。 


实例 231 修改 XML 元 素 的 内 容 


【导语 】 

本 实例 将 首先 演示 运用 LINQ 语句 查询 出 符合 条 件 的 XML 元 素 ,然后 对 该 元 素 中 某 
个 子 元 素 的 内 容 进行 修改 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 用 于 测试 的 XML 元 素 。 


{ 
XElement testel = new XElement("Productios", 
new XElement ("Product", 
new XElement("id", 1201), 
new XElement("desc", "产品 A"), 
new XElement ("mode", 7)), 
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new XElement ("Product", 


} 


XElement 


不 依赖 文档 相关 的 属性 ,可 以 不 与 XDocument 类 


关联 。 


步骤 3: 使 用 LINQ 语句 查询 出 mode 子 元 素 中 
内 容 为 3 的 Product 元 素 。 
var q = from x in testel.Elements() 


where (int)x,Element("mode") == 3 
select x; 


步骤 4: 修改 这 个 Product 元 素 下 面 desc 子 元 素 


的 内 容 。 


if(q.Count() > 0) 


{ 


XElement e = q.First(); 
e.Element("desc") .Value = "产品 G6"; 


} 


访问 元 素 实 例 的 Value 属性 可 以 修改 该 元 素 中 


的 内 容 。 


new XElement("id", 1202), 
new XElement("desc", "产品 B"), 
new XElement ("mode", 3))); 


类 可 以 直接 用 于 产生 XML 元素, 如 果 


图 7-14 修改 前 后 的 XML 元 素 对 比 


步骤 5: 运行 应 用 程序 示例 ,输出 结果 如 图 7-14 
所 示 。 修 改 XML 元 素 后 , “产品 B” 已 经 变 成 “产品 G”。 


实例 232 ”使 用 并 行 LINQ 


【导语 】 


开启 LINQ 查询 的 并 行 模式 ,只 需要 在 原 序列 上 调用 AsParallel 扩展 方法 ,但 是 不 应 该 


滥用 并 行 模式 。 如 果 查 询 的 量 很 小 ,并 且 在 查询 的 过 程 没 有 过 于 复杂 的 处 理 ， 


用 并 行 模式 。 


满足 以 下 条 件 的 查询 ,可 以 考虑 以 并 行 模 式 执行 : 


(1) 序列 


Ph 数据 量 很 大 。 


(2) LINQ 查询 中 where 与 select 子 句 上 需要 额外 的 处 理工 作 ( 例 


(3) 对 产 和 4 


E 的 结果 没有 严格 的 顺序 要 求 (尽管 并 行 查询 可 以 调用 


来 维持 序列 的 顺序 ,但 在 一 定 程度 上 会 降低 性 能 , 仅 在 必要 时 使 用 ) 。 
本 实例 将 定义 一 个 Rectangle 结构 , 它 表 示 一 个 矩形 的 信息 ,其 中 


字段 。 实 例 代码 以 并 行 方式 生成 一 个 庞大 的 Rectangle 序列 ,然后 分 别 用 普通 


AsOrdered 扩 


- 般 不 建议 使 


如 要 转换 类 型 ) 。 


展 方 法 


度 两 个 
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进行 LINQ 查询 ,最 后 分 别 统计 出 两 种 模式 下 执行 LINQ 查询 所 消耗 的 时 间 ( 单 位 是 ms) 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 Rectangle 结构 。 


public struct Rectangle 
{ 
public double Width; 
public double Height; 
上 


步骤 3: 初始 化 Rectangle 序列 ,本 例 使 用 ConcurrentQueue < 本 > 集合 来 包装 ,该 集合 
支持 并 行 操作 ,并 且 是 线程 安全 的 。 


ConcurrentQueue < Rectangle > testList = new ConcurrentQueue < Rectangle>(); 
步骤 4: 以 并 行 方式 向 集合 中 添加 元 素 。 


Parallel. For(20, 300000000, n => 
{ 
testList. Enqueue( new Rectangle 
{ 
Width = n, 
Height = n 
D); 
DE 


步骤 5: 分 别 以 普通 模式 、 并 行 模 式 执 行 LINQ 查询 ,在 select 子 句 中 计算 和 矩形 的 面积 。 
Stopwatch 组 件 的 作用 是 计算 执行 代码 所 耗费 的 时 间 , 详 见 代 码 清单 7-4。 
代码 清单 7-4 ”两 种 模式 执行 LINQ 的 对 比 


Stopwatch watch = new Stopwatch(); 
watch. Restart( ); 
var ql = from x in testList 
select x.Width * x.Height; 
watch. Stop( ); 
Console. WriteLine( "普通 模式 , 耗 时 :{0} ms",， watch. ElapsedMilliseconds); 


watch. Restart( ); 
var q2 = from x in testList. AsParallel() 
select x. Width * x.Height; 
watch. Stop( ); 
Console. WriteLine(" 并 行 模式 , 耗 时 :{0} ms",， watch. ElapsedMilliseconds); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 7-15 所 示 。 
从 输出 结果 来 看 ,在 并 行 模式 下 执行 LINQ 查询 确实 提升 了 性 能 。 
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图 7-15 两 种 模式 耗 时 对 比 


注意 : Stopwatch 组 件 自身 在 运行 期 间 也 会 占用 一 定 的 CPU 资源 ,因此 该 组 件 所 统计 的 耗 
时 并 非 完 全 准确 , 仅 供 参考 。 


实例 233 ”将 XML 转换 为 元 组 


【导语 】 

LINQ 查询 语句 通常 是 通过 select 子 句 实现 数据 转换 的 。 本 实例 将 通过 LINQ 语句 查 
询 某 个 XML 元 素 下 的 子 元 素 列 表 , 并 在 select 子 句 后 返回 二 元 组 ,元 组 中 的 字段 对 应 着 
XML 元 素 中 相应 Attribute( 特 性 ) 的 值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 XML 测试 数据 ,其 中 包含 一 个 Items 根 元 素 , 根 元 素 下 有 三 个 Item 元 素 ， 
每 个 元 素 中 带 有 两 个 特性 一 一 Vall 和 Val2。 


XElement xml = new XElement("Items", 
new XElement("Item", 
new XAttribute("Vall", 100), 
new XAttribute("Val2", 250)), 
new XElement("Item", 
new XAttribute("Vall", 7500), 
new XAttribute("Val2", 900)), 
new XElement("Item", 
new XAttribute("Vall", 2003), 
new XAttribute("Val2", 6230))); 


步骤 3: 用 LINQ 查询 上 述 XML 数据 中 的 Item 元 素 ,并 将 它 的 特性 值 转换 为 元 组 中 
的 字段 值 。 


var q = from el in xm1l.Elements("Item") 
let vl = Convert.ToInt32(el.Attribute("Vall").Value) 
let v2 = Convert.ToInt32(el.Attribute("Val2").Value) 
select (Value 1: vi, Value 2: v2); 
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步骤 4: 输出 元 组 序列 中 每 个 字段 的 值 。 


foreach(var t in q) 
{ 

Console. WriteLine( $ "Value 1 : {t.Value 1}\nValue 2 : {t.Value 2}\n"); 
} 


步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 7-16 所 示 。 


图 7-16 XML 数据 转换 为 二 元 组 


实例 234 ”生成 带 命 名 空间 的 XML 文档 
【导语 】 
使 用 XElement 类 创建 XML 元 素 时 ,可 以 搭配 使 用 XNamespace 类 来 定义 XML 命名 


空间 。 将 XNamespace 实例 与 XML 元 素 的 名 字 直 接连 接 起 来 (如 同 用 “十 ”运算 符 拼接 字 
符 串 一 样 ) ,命名 空间 就 会 自动 与 元 素 关联 了 (XNamespace 类 内 部 实现 了 运算 符 重 载 ) 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 XML 命名 空间 。 


XNamespace ns = "http://demo.org"; 


XNamespace 类 内 部 有 实现 隐 式 转换 ,因此 直接 可 以 将 字符 串 实例 赋 给 XNamespace 


天 型 的 变量 。 


步骤 3: 实例 化 三 个 XML 元 素 , 均 使 用 以 上 定义 的 ns 变量 为 XML 文档 的 命名 空间 。 


XElement nl = new XElement(ns + "Group"， 
new XElement(ns + "Name", "Jack"), 
new XElement(ns + "Level", 3)); 
XElement n2 = new XElement(ns + "Group", 
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new XElement(ns + "Name", "Tom"), 
new XElement(ns + "Level", 2)); 
XElement n3 = new XElement(ns + "Group", 
new XElement (ns + "Name", "Jim"), 
new XElement(ns + "Level", 7)); 


步骤 4: 再 声明 一 个 XML 元 素 , 将 上 述 三 个 元 素 都 包装 起 来 。 
XElement root = new XElement(ns + "Groups", nl, n2, n3); 

步骤 5: 输出 刚 生 成 的 XML 内 容 。 

Console. WriteLine(root) ; 


步骤 6: 运行 应 用 程序 实例 ,控制 台 输 出 结果 如 图 7-17 所 示 。 


Ci\Program Filesvdotn 一 口 x 


图 7-17 带 命 名 空间 的 XML 元 素 


实例 235 ”添加 命名 空间 前 级 


【导语 】 

-个 XML 文档 中 所 使 用 的 元 素 可 能 会 来 自 于 不 同 的 命名 空间 ,为 了 能 够 区 分 来 自 不 
同 命 名 空间 的 元 素 ,或 者 来 自 不 同 命名 空间 的 同名 元 素 ,需要 为 命名 空间 添加 一 个 前 级 ,这 
个 前 级 类 似 于 命名 空间 的 别名 ,在 同一 个 文档 中 不 会 重复 出 现 。 

XML 命名 空间 的 前 组 是 通过 XAttribute 类 将 其 作为 元 素 特性 添加 到 文档 中 的 , 形 如 : 


xmlns:abc = "http. temp.orp" 
有 “abc” 为 命名 空间 的 前 级 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 两 个 备用 的 XML 命名 空间 。 


这 


XNamespace nsl = "demol.org"; 
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XNamespace ns2 = "demo2.org"; 
步骤 3: 声明 两 个 XAttribute 实例 ,为 以 上 两 个 命名 空间 添加 前 级 。 


XAttribute profileAttl 
XAttribute profileAtt2 


new XAttribute(XNamespace. Xmlns + "na", ns1); 
new XAttribute( XNamespace. Xmlns + "nb", ns2); 


特性 中 的 “xmlns” 字 段 可 以 通过 访问 XNamespace 类 的 Xmlns 静态 属性 直接 获取 , 随 
后 紧 跟 的 是 命名 空间 前 级 的 名 称 , 此 处 分 别 命名 为 “na” 和 “nb”。 
步骤 4: 创建 XML 元 素 及 其 子 元 素 。 
XElement xml = new XElement(nsl + "Root", profileAttl, profileAtt2, 
new XElement(nsl + "Layout1l", "Border"), 
new XElement(ns2 + "Layout2", "Canvas")); 
将 上 述 定义 的 用 于 指定 命名 空间 别名 的 两 个 特性 分 别 应 用 到 Root 元 素 上 。 子 元 素 会 
继承 特性 中 指定 的 别名 ,因此 Root 的 子 元 素 无 须 再 添加 xmlns 特性 。 
步骤 5: 生成 的 XML 文档 如 下 。 
<na:Root xmlns:na= "demol.org" xmlns:nb= "demo2. org"> 
<na:Layoutl > Border </na:Layoutl > 


<nb:Layout2 > Canvas </nb:Layout2 > 
</na:Root > 


Root、Layoutl 元 素 都 来 自 demol. org 命名 空间 ,Layout2 来 自 demo2. org 命名 空间 。 
7.3 动态 类 型 


实例 236 ”通过 ExpandoObject 类 创建 动态 实例 


【导语 】 

需要 使 用 dynamic 关键 字 来 声明 动态 类 型 ,并 且 在 编译 阶段 动态 对 象 不 会 进行 解析 ,而 
是 在 运行 阶段 进行 解析 ,因此 在 代码 编辑 器 中 输入 代码 时 ,不 会 出 现成 员 列 表 的 智能 提示 。 
开发 人 员 在 访问 动态 类 型 的 成 员 时 ,一 定 不 能 将 成 员 的 名 字 输 错 了 。 

ExpandoObject 是 专 为 动态 类 型 而 封装 的 类 型 ,可 以 把 该 类 型 的 新 实例 赋值 给 用 
dynamic 关键 字 声 明 的 变量 ,随后 就 可 以 作为 动态 对 象 来 访问 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Dynamic; 


步骤 3: 声明 动态 类 型 的 变量 ,再 用 ExpandoObject 的 新 实例 进行 初始 化 。 
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dynamic dx = new ExpandoObject(); 
步骤 4: 给 动态 类 型 的 成 员 赋 值 ,成 员 名称 无 须 事先 定义 , 它 会 在 运行 阶段 动态 添加 。 


dx. Message = "Hello"; 
dx. Time = new DateTime(2009, 2, 1, 23, 54, 16); 


步骤 5: 访问 动态 类 型 的 成 员 , 并 输出 成 员 的 值 。 


Console. WriteLine( $ "Message = {dx.Message}\nTime = {dx.Time}"); 


注意 : 成 员 名 称 一 定 要 与 前 面 写 入 时 用 的 名 称 保持 一 致 。 


步骤 6: 运行 应 用 程序 ,输出 内 容 如 下 。 


Message = Hello 
Time = 2009—-2—1 23:54:16 


实例 237 ”以 字典 形式 访问 ExpandoObject 


【导语 】 

因为 ExpandoObject 类 显 式 实现 了 IDictionary 接口 ,所 以 能 够 作为 字典 类 型 来 访问 。 
运行 阶段 向 ExpandoObject 实例 添加 的 动态 成 员 名 称 , 会 以 字符 串 形式 存放 在 动态 类 型 中 。 

如 果 以 字典 形式 访问 ExpandoObject 对 象 ,需要 将 它 将 转换 为 IDictionary 接口 ,再 通 
过 该 接口 去 读 取 里 面 的 数据 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Dynamic; 
using System. Collections. Generic; 


步骤 3: 声明 动态 类 型 变量 ,并 初始 化 其 成 员 。 


dynamic d = new ExpandoObject(); 
d. AppName = "Sample"; 
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d.Desc = "test application"; 
d.Release = 5; 


步骤 4: 使 用 IDictionary 接口 引用 动态 类 型 实例 。 
IDictionary < string, object> dic = di; 


步骤 5: 使 用 foreach 循环 读 出 字典 中 的 Key 和 Value 的 值 。 


foreach(var i in dic) 
{ 

Console. WriteLine( $ "{i. Key} : {i.Value}"); 
} 


步骤 6: 运行 应 用 程序 ,输出 内 容 如 下 。 


AppName : Sample 


Ver : 1.0.3 

Desc : test application 

Release : 5 

实例 238 自 定义 的 动态 类 型 
【导语 】 


尽管 框架 提供 了 默认 的 动态 类 型 处 理 方案 ,也 封装 了 ExpandoObject 类 供 开 发 人 员 使 
用 ,但 是 有 时 候 在 开发 过 程 中 会 有 特殊 需求 ,这 种 情况 下 框架 所 提供 的 方案 也 许 不 能 解决 现 
有 问题 ,开发 人 员 可 以 考虑 编写 自 定 义 的 动态 类 型 。 

编写 自 定 义 动态 类 型 的 整体 思路 : 从 DynamicObject 类 派生 出 自己 的 类 型 ,然后 根据 
需要 有 选择 地 重 写 DynamicObject 类 的 虚 方法 (在 声明 时 虚 方法 使 用 virtual 关键 字 ) 。 

一 般 情况 下 ,开发 人 员 需 要 重点 重 写 以 下 两 个 虚 方法 。 

(1) TrySetMember: 该 方法 类 似 于 为 公共 属性 或 字段 赋值 ,调用 格式 为 obj. Property 
= 105。 

(2) TryGetMember: 类 似 于 访问 字段 或 属性 ,主要 是 读 取 内 容 , 形 如 a = obj. 
Property。 

另外 ,可 能 需要 重 写 以 下 几 个 方法 。 

(3) TryInvokeMember: 类 似 于 方法 调用 , 形 如 obj. Add( … ) 。 

(4) TryInvoke: 模拟 委托 对 象 的 调用 形式 , 形 如 obj( … )。 

(5) TryBinaryOperation: 模拟 运算 符 , 例 如 按 位 “与 ”、 加 减法 等 运算 。 

(6) TryGetIndex 和 TrySetIndex: 类 似 于 索引 器 。 

本 实例 将 自 定义 一 个 动态 类 型 , 重 写 TryGetMember 和 TrySetMember 方法 ,实现 get 
和 set 访问 器 ,该 动态 类 型 内 部 使 用 字典 集合 来 存放 数据 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 类 ,从 DynamicObiject 类 派生 。 

public class CustomDynamicObject : DynamicObject 

{ 


} 
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步骤 3: 重 写 TryGetMember 方法 ,完成 get 访问 器 。 


public override bool TryGetMember(GetMemberBinder binder, out object result) 
{ 

return _data. TryGetValue(binder. Name. ToLower(), out result); 
} 


binder 参数 中 包含 访问 动态 类 型 时 传递 的 调用 数据 ,例如 成 员 名 字 ,返回 值 类 型 等 。 
步骤 4: 重 写 TrySetMember 方法 ,实现 set 访问 器 。 


public override bool TrySetMember(SetMemberBinder binder，object value) 
{ 
return _data. TryAdd(binder. Name. ToLower(), value); 


¥ 


步骤 5: 在 Main 方法 中 使 用 上 述 自 定义 动态 类 型 。 声 明 变量 时 需要 使 用 dynamic 关 
键 字 ,然后 用 自 定 义 动态 类 型 的 新 实例 为 变量 赋值 。 


dynamic dv = new CustomDynamicObject(); 


步骤 6: 为 动态 对 象 赋值 。 


dv. ItemA = 30000; 
dv. ItemB = (uint)500000; 
dv. ItemC = 'p'; 


注意 : 动态 类 型 的 成 员 名 称 将 在 运行 阶段 解析 ,因此 在 输入 代码 时 不 会 有 智能 提示 。 


步骤 7: 输出 动态 类 型 各 成 员 的 值 ,以 及 成 员 值 的 数据 类 型 。 


Console. WriteLine( $ "ItemA : {dv. ItemA}, {dv. ItemA.GetType()}"); 
Console. WriteLine( $ "ItemB : {dv. ItemB}, {dv. ItemB.GetType()}"); 
Console. WriteLine( $ "ItemC : {dv. ItemC}, {dv. ItemC.GetType()}"); 


步骤 8: 运行 应 用 程序 ,控制 台 的 输出 文本 如 图 7-18 所 示 。 


Chprogramfiles.. — 口 Xx 


图 7-18 输出 自 定义 动态 类 型 的 成 员 


实例 239 在 自 定义 动态 类 型 中 直接 定义 成 员 


【导语 】 
在 从 DynamicObject 类 派生 时 ,可 以 通过 重 写 TryGetMember、TrySetMember 等 方法 
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来 响应 调用 代码 的 成 员 访问 。 实 际 上 ,开发 者 可 以 在 自 定 义 的 动态 类 型 上 直接 定义 成 员 , 如 
字段 、 属 性 方法 等 。 在 应 用 程序 运行 期 间 , 会 优先 查找 并 解析 类 中 已 经 定义 的 成 员 ,如 果 调 
用 方 所 指定 的 成 员 未 在 类 中 定义 , 才 会 去 调用 TryGetMember 等 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 从 DynamicObject 类 派生 出 一 个 自 定义 的 动态 类 型 。 

public class MyDynamic : DynamicObject 

€ 


private IDictionary < string, object > data = new Dictionary< string, object >(); 


// 明确 定义 的 属性 ,动态 类 型 会 直接 访问 该 属性 
public string WorkDescription { get; set; } 
public string WorkName { get; set; } 

public bool IsStarted { get; set; } 


// 其 他 未 声明 的 属性 就 通过 重 写 的 TryGetMember 和 TrySetMember 方法 访问 
public override bool TryGetMember(GetMemberBinder binder, out object result) 
{ 

Console. WriteLine( $"\n 类 中 未 定义 的 成 员 :{binder. Name}\n"); 

return data. TryGetValue(binder. Name. ToLower(), out result); 
} 
public override bool TrySetMember(SetMemberBinder binder, object value) 
{ 

Console. WriteLine( $"\n 类 中 未 定义 的 成 员 :{binder. Name}\n"); 

return data. TryAdd( binder. Name. ToLower(), value); 


} 


在 上 述 类 中 , WorkDescription、WorkName IsStarted 是 类 型 明确 定义 的 成 员 , 在 访问 
动态 类 型 时 ,如 果 调 用 方 访问 的 成 员 名 称 与 它们 匹配 , 则 它们 会 被 优先 访问 ; 如 果 调 用 方 请 
求 访 问 的 成 员 名 称 在 类 中 未 定义 , 转 而 访问 TrySetMember 方法 和 TryGetMember 方法 。 

步骤 3: 在 Main 方法 中 声明 动态 类 型 变量 ,并 用 MyDynamic 类 的 新 实例 对 其 初始 化 。 


dynamic d = new MyDynamic(); 


步骤 4: 向 动态 类 型 对 象 的 成 员 赋值 。 


d. WorkName = "冲压 工序 "; // 已 定义 成 员 
d. WorkDescription = "此 工序 需要 持续 较 长 的 时 间 "; // 已 定义 成 员 
d. IsStarted = false; // 已 定义 成 员 
d.WorkType = 15; // 未 定义 成 员 


d. StartTime = new DateTime(2018, 8, 3); // 未 定义 成 员 
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步骤 5: 在 控制 台中 输出 部 分 成 员 的 内 容 。 


Console. WriteLine( $ "Work Name : {d. WorkName}"); 
Console. WriteLine( $ "Start Time : {d. StartTime}"); 
Console. WriteLine( $ "Work Type : {d. WorkType}"); 


步骤 6: 运行 应 用 程序 ,输出 内 容 如 图 7-19 所 示 。 


CaprogramFiles\do.. 一 口 x 


图 7-19 调用 带 已 定义 成 员 的 动态 类 型 


实例 240 ”模拟 委托 实例 的 调用 


【导语 】 

在 继承 DynamicObject 类 时 重 写 TryInvoke 方法 ,可 以 模拟 委托 类 型 的 调用 方式 。 方 
法 原型 如 下 : 

bool TryInvoke( InvokeBinder binder, object[] args, out object result); 


其 中 ,args 参数 表示 在 调用 时 传递 进来 的 参数 列表 ,result 参数 表示 调用 结果 。 
本 实例 将 通过 重 写 TryInvoke 方法 来 模拟 委托 实例 的 调用 ,并 且 将 传递 的 参数 进行 累 
加 ,最 后 输出 计算 结果 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 从 DynamicObject 类 派生 一 个 自 定义 类 ,并 重 写 TryInvoke 方法 。 
public class MyCustDynamic : DynamicObject 
{ 
public override bool TryInvoke( InvokeBinder binder, object[ ] args, out object result) 
{ 
result = 05 


int temp = 0; 
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foreach( int n in args.Cast < int >()) 
‘ 
temp += n; 

} 

result = temp; 

return true; 
} 
步骤 3: 在 Main 方法 中 以 动态 类 型 方式 实例 化 MyCustDynamic 类 。 
dynamic d = new MYCustDynamic( ); 
步骤 4: 模拟 委托 实例 调用 ,并 接收 调用 结果 。 
intr = d(2, 10, 15, 7); 
步骤 5: 运行 应 用 程序 ,得 到 的 计算 结果 如 下 。 
计算 结果 : 34 


第 二 篇 技术 进 阶 


掌握 上 一 篇 章 中 的 基础 知识 后 ,读者 将 在 本 篇 中 学 习 到 以 下 常用 
的 技术 模块 。 

。 文件 与 目录 的 常用 操作 (如 创建 与 删除 文件 ); 

。 流 (Stream) 对 象 的 运用 (内 存 流 、 文 件 流 等 ); 

。 序列 化 与 反 序 列 化 ; 

。 多 线程 与 异步 编程 ; 

。 数据 的 加 密 与 解密 ; 
网 络 通信 技术 的 应 用 (Socket 编程 HTTP 交互 ); 
。 反射 (在 运行 时 获取 类 型 信息 ,动态 调用 类 型 或 类 型 成 员 ) 。 


文件 与 IO 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 目录 与 文件 ; 

。 流 ; 

。 压缩 与 解压 缩 ; 

。 内 存 映 射 文件 ; 

。 命 名 管道 。 


8.1 目录 与 文件 


实例 241 创建 目录 与 文件 


【导语 】 

本 实例 将 演示 Directory 类 和 File 类 的 使 用 方法 。Directory 类 公开 了 一 系列 静态 方 
法 ,可 以 很 方便 地 操作 目录 ,例如 创建 目录 、 删 除 目 录 等 。File 类 的 功能 与 Directory 类 相 
似 , 它 也 公开 了 一 系列 静态 方法 ,以 便 对 文件 进行 操作 ,例如 创建 文件 .向 文件 写 人 数据 、 删 
除 文件 等 。 

【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 当前 应 用 所 在 的 目录 下 新 建 子 目录 ,命名 为 test_dir。 


Directory. CreateDirectory("test dir"); 
步骤 3: 在 test_dir 目录 下 创建 一 个 新 文件 ,命名 为 sample. data。 
var stream = File.Create("test dir/sample. data"); 


调用 Create 方法 后 ,返回 一 个 FileStream 实例 ,随后 可 以 通过 该 对 象 向 文件 写 入 内 容 。 
步骤 4: 向 新 文件 中 写 入 5 字 节 。 


byte[ ] buffer = {5,7,9,11,13}; 
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stream. Write(buffer, 0, buffer. Length); 
stream. Close( ); 
stream. Dispose( ); 


FileStream 实例 是 流 对 象 ,使 用 完 之 后 必须 释放 ,避免 应 用 程序 长 时 间 占 用 文件 资源 。 
实例 242 ”修改 文件 的 创建 时 间 


【导语 】 

File 类 公开 了 一 对 可 以 操作 文件 的 创建 时 间 的 静态 方法 : GetCreationTime 方法 返回 
指定 文件 的 创建 时 间 ,SetCreationTime 方法 则 用 于 修改 文件 的 创建 时 间 。 与 创建 时 间 相 
似 , 可 以 通过 GetLastAccessTime 和 SetLastAccessTime 方法 来 读 写 文 件 的 最 后 访问 时 间 ， 
也 可 以 通过 GetLastWriteTime 和 SetLastWriteTime 方法 来 读 写 文件 的 最 后 写 人 时间。 

本 实例 首先 创建 文件 ,然后 修改 文件 的 创建 时 间 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 新 文件 。 

string file_name = "testFile"; 

// 创建 文件 


using(var s = File.Create(file name)) 
{ 

s. WriteByte(100); 

s. WriteByte(200); 
} 


步骤 3: 输出 文件 的 创建 时 间 。 
Console. WriteLine( $ "文件 {file_name} 的 创建 时 间 :{File. GetCreationTime(file_nanme)}"); 
步骤 4: 修改 文件 的 创建 时 间 。 


DateTime creationTime = new DateTime(2016, 8, 16, 23, 14, 50); 
File. SetCreationTime(file name, creationTime); 


步骤 5: 再 次 输出 文件 的 创建 时 间 。 


Console. WriteLine( $ "修改 后 ,文件 {file_name} 的 创建 时 间 为 : {File. GetCreationTime (file_ 
name)}"); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 8-1 所 示 。 


图 8-1 修改 前 后 的 创建 时 间 


步骤 7: 打开 所 创建 文件 的 “属性 ”窗口 ,可 以 看 到 修改 后 的 创建 时 间 , 如 图 8-2 所 示 。 
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创建 时 间 : 2016 年 8 月 16 日 ，23:14:50 
修改 时 间 : 2018 年 7 月 23 日 ，16:50:40 


访问 时 间 。 。 2018 年 7 月 23 日 ，16.39.55 
图 8-2 系统 显示 文件 的 创建 时 间 


实例 243 ”使 用 FileInfo 类 来 创建 文件 

【导语 】 

File 类 提供 的 静态 方法 使 用 简便 , 除 File 类 公开 的 方法 外 ,开发 人 员 也 可 以 使 用 
FileInfo 类 来 创建 文件 。 与 File 不 同 ,在 使 用 FileInfo 前 需要 进行 实例 化 ,传递 给 构造 函数 
的 参数 为 要 处 理 的 文件 名 (相对 路 径 或 绝对 路 径 )。 实 例 化 FileInfo 对 象 后 ,可 以 调用 实例 
方法 Create 来 创建 新 文件 ,该 方法 调用 后 返回 一 个 文件 流 实 例 (FileStream) ,可 用 于 向 文件 
写 和 信 内容。 类似 地 ,对 于 DirectoryInfo 类 ,也 可 以 先进 行 实例 化 ,然后 调用 Create 方法 来 创 
建 目 录 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 应 用 程序 项 目 。 

步骤 2: 创建 FileInfo 实例 。 


FileInfo file = new FileInfo("test data"); 
步骤 3: 调用 Create 方法 创建 新 文件 ,并 向 该 文件 写 人 数据 。 


using(var s = file.Create()) 
{ 
s. Write(new byte[ ] { 55, 13, 27, 4, 16 }); 
} 
步骤 4: 运行 示例 程序 后 ,在 应 用 程序 所 在 目录 会 生成 一 个 test_data 文件 ,可 以 通过 系 
统 的 “属性 窗口 查看 刚 新 建 的 文件 ,如 图 8-3 所 示 。 


实例 244 判断 目录 是 否 已 经 存在 


【导语 】 

要 分 析 指 定 的 目录 是 否 存在 ,有 两 种 方法 : 

(1) 直接 调用 Directory 类 的 Exists 方法 ,并 将 待 分 析 目 录 的 完整 路 径 传递 给 方法 ,如 
果 目 录 已 经 存在 ,Exists 方法 返回 true, 和 否则 返回 false。 

(2) 先 用 待 分 析 目 录 的 路 径 创建 一 个 DirectoryInfo 实例 ,再 通过 其 Exists 属性 来 判断 
目录 是 否 存在 。 

对 应 地 ,如 果 要 判断 一 个 文件 是 否 存在 ,可 以 调用 File 类 的 Exists 方法 ,或 者 使 用 
FileInfo 类 的 Exists 属性 。 
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图 test data 
文件 类 型 : 文件 
搞 述 : test data 
位 置 : e\repos\Demo\Demo\bin\Debug\netcoreapp2.1 
大 小 5 字 匠 5 字 吉 | 


占用 空间 : 0 字 节 


创建 时 间 : 2018 年 7 月 23 日 ，17:11:03 
修改 时 间 : ”2018 年 7 月 23 日 ，17:11:03 
访问 时 间 : 2018 年 7 月 23 日 ，17:11:03 


大 全: DORER OR RD | 


_”w  _| 加 于 到 | 


图 8-3 查看 文件 属性 


【操作 流程 】 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 字符 串 类 型 的 变量 ,表示 目录 的 名 称 。 


string dirName = "sample_ folder"; 
步骤 3: 当 目 录 不 存在 的 情况 下 ,创建 该 目录 。 


if (!Directory. Exists(dirName)) 
{ 
Directory. CreateDirectory(dirName); 


} 

如 果 目 录 已 经 存在 ,那么 就 不 会 去 创建 目录 了 。 

实例 245 ”向 文件 追加 文本 

【导语 】 

以 “Append” 开 头 的 方法 ,都 是 用 于 向 文件 追加 内 容 的 ,其 特点 是 : 如 果 文 件 不 存在 ,将 
创建 新 文件 ,并 写 和 内容; 如 果 文 件 已 经 存在 且 文件 中 已 有 内 容 ,就 从 文件 的 末尾 开始 写 
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入 , 即 文件 原 有 的 内 容 不 会 被 删除 。 

File 类 公开 了 以 下 几 种 追加 方法 。 

(1) AppendAllLines: 写 人 的 内 容 以 行为 单位 ,内 容 中 的 每 个 元 素 单独 写 入 一行 ,元 素 
后 面 自动 追加 换行 符 。 

(2) AppendAllText: 以 文件 末尾 为 写 人 点 ,一 次 性 将 内 容 写 和 人 文件 ,内 容 结尾 不 会 自 
动 添加 换行 符 。 

(3) AppendText: 此 方法 最 为 灵活 。 它 返回 一 个 StreamWriter, 支 持 向 文件 写 人 各 种 
数据 类 型 的 内 容 , 如 char、int 等 。 

本 实例 将 演示 AppendAllText 方法 的 使 用 ,将 四 名 唐诗 写 人 文本 文件 ,其 中 第 二 次 写 
入 的 文本 中 带 有 换行 符 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 字符 串 变量 ,存放 文件 名 。 


string file name = "abc, txt"; 
步骤 3: 依次 向 文件 追加 四 句 唐诗 。 


File. AppendAllText(file_name, "绝对 有 佳人 ,"); 

File. AppendAllText(file_name, "项 居 在 空谷 。\r\n"); 

File. AppendAllText(file_name, " 自 云 良家 子 ,"); 

File. AppendAllText(file_name, "零落 依 草木 。"); 

步骤 4: 按 下 F5 快捷 键 运行 程序 。 

步骤 $: 待 程序 执行 结束 后 ,打开 项 目的 \bin\Debug\netcoreapp < 版 本 号 > 子 目 录 , 会 看 到 
有 一 个 abc. txt 文件 ,用 记事 本 打开 该 文件 ,就 能 看 到 本 实例 所 写 入 的 内 容 , 如 图 8-4 所 示 。 


图 8-4 被 追加 的 内 容 


注意 : 为 了 能 在 记事 本 中 查看 文件 时 呈现 换行 效果 ,示例 中 使 用 的 换行 符 为 \r\n, 即 回 车 符 
与 换行 符 的 结合 。 
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实例 246 ” 覆 写 文件 内 容 


【导语 】 

以 “Write” 开 头 的 方法 ,不 同 于 以 “Append” 开 头 的 方法 。Append* 方法 不 会 删除 文件 
原 有 的 内 容 , 而 Write "方法 是 先 清除 文件 原 有 的 内 容 , 再 重新 写 和 人 。 

本 实例 将 演示 WriteAllText 方法 的 使 用 方法 ,三 次 写 入 文件 ,而 最 终 只 保留 最 后 一 次 
写 人 的 内 容 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变量 ,存放 文件 名 。 


string fileName = "abc.txt"; 


步骤 3: 调用 WriteAllText 方法 ,分 三 次 写 入 文件 。 


文 作 (。 编 名 (6 格式 (O) 查看 (V) 帮助 (H) 
File. WriteAllText(fileName, "第 一 次 写 人 的 文本 。"); 三 次 写 入 的 文本 。 


File. WriteAllText(fileName, "第 二 次 写 人 的 文本 。"); 
File. WriteAllText(fileName, "第 三 次 写 人 的 文本 。"); 


步骤 4: 运行 示例 程序 。 

步骤 5: 待 程序 执行 结束 后 ,找到 项 目 目录 下 的 \bin 
\Debug\netcoreapp > 版 本 号 > 子 目 录 , 打 开 abc. txt 文 
件 , 如 图 8-5 所 示 ,文件 中 只 保留 最 后 一 次 写 入 的 内 容 。 


实例 247 ”使 用 FileInfo 类 删除 文件 


【导语 】 

删除 文件 有 两 种 方法 : 第 一 种 方法 是 直接 调用 File 类 的 Delete 方法 ,此 方法 为 静态 方 
法 ; 第 二 种 方法 是 先 实例 化 FileInfo 类 ,然后 调用 Delete 实例 方法 删除 文件 。 

本 实例 将 通过 FileInfo 实例 来 演示 文件 的 删除 操作 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变 量 , 用 于 存放 文件 名 。 


图 8-5 保留 最 后 写 入 的 内 容 


string fileName = "test"; 

步骤 3: 创建 FileInfo 实例 。 

FileInfo info = new FileInfo(fileNane); 

步骤 4: 判断 文件 是 否 已 存在 ,如 果 存 在 ,就 调用 Delete 方法 删除 文件 。 


if (info.Exists) 
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{ 
info. Delete( ); 
} 


步骤 5: 删除 文件 后 ,重新 创建 文件 ,并 在 文件 中 写 入 随机 生成 的 字 节 。 


using (var fs = info.Create()) 

{ 
byte[ ] buffer = new byte[512]; 
// 用 于 产生 随 字 节 
Random rand = new Random(); 
rand. NextBytes( buffer); 
fs. Write(buffer); 

} 


实例 248 ”以 行 的 形式 写 人 文本 


【导语 】 

以 行 的 形式 写 入 文本 ,会 自动 在 每 个 文本 元 素 的 后 面 加 上 换行 符 。File 类 提供 两 种 写 
入 文 本 的 方法 : 一 种 是 AppendAllLines 方法 , 它 在 文件 现 有 的 内 容 上 写 入 新 文本 ; 另 一 种 
是 WriteAllLines 方法 , 它 会 将 文件 现 有 的 内 容 删 除 ,然后 再 写 入 新 的 文本 。 

本 实例 将 演示 AppendAllLines 方法 的 用 法 , 它 在 写 入 过 程 中 不 会 删除 原 有 的 内 容 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 字符 串 变量 ,存放 文件 名 。 


string fileName = "1.txt"; 
步骤 3: 准备 要 写 入 文件 的 四 行文 本 ,也 就 是 一 个 字符 串 数组 。 


String[ ] lines = 

{ 
"第 一 行文 本 "， 
"第 二 行文 本 "， 
"第 三 行文 本 "， 
"第 四 行文 本 " 

}; 


待 写 入 的 文本 中 不 要 求 带 有 换行 符 ,因为 AppendAllLines 方法 会 自动 在 字符 串 后 面 加 
上 换行 符 。 
步骤 4: 调用 AppendAllLines 方法 ,将 上 述 字符 串 数 组 中 的 文本 写 和 人 目标 文件 。 


File. AppendAllLines(fileName, lines); 


步骤 5: 按 快捷 键 F5 运行 应 用 程序 。 
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步骤 6: 待 程序 执行 完成 之 后 ,找到 项 目 目录 下 的 \bin\Debug\netcoreapp < 版 本 号 > 子 
目录 ,打开 1. txt 文件 ,就 可 以 看 到 写 入 的 四 行文 本 了 ,如 图 8-6 所 示 。 


文件 (F) 编辑 (E) 格式 (O) 查看 (V) 帮助 (H) 


图 8-6 已 写 入 四 行文 本 


实例 249” 重 命名 目录 


【导语 】 

若 需 要 重 命名 目录 ,可 以 使 用 Move 方法 。Move 方法 的 主要 功能 是 移动 文件 或 目录 ， 
但 也 可 以 用 于 实现 文件 或 目录 的 重 命 名 ,原理 是 将 原来 的 文件 或 目录 移动 到 相同 的 位 置 , 但 
在 移动 的 目标 位 置 使 用 新 的 名 字 。 

本 实例 演示 了 使 用 Move 方法 来 重 命名 目录 ,文件 的 重 命名 方法 类 似 。 

【操作 流程 】 

步骤 1: 创建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 字符 串 变 量 ,分别 表 示 重 命名 前 后 的 目录 名 称 。 


string oldName = "test 1"; 


"test 2"; 


string newName 
步骤 3: 用 oldName 作为 目录 名 称 创建 一 个 新 目录 。 
Directory. CreateDirectory(oldName) ; 


步骤 4: 调用 Move 方法 移动 创建 好 的 目录 ,目标 为 新 的 目录 名 称 , 即 newName 变量 所 
指定 的 名 称 。 


Directory. Move(oldName, newName); 

步骤 5: 运行 应 用 程序 。 

步骤 6: 待 程序 执行 完成 后 ,在 项 目 所 在 的 目录 下 找到 \bin\Debug\netcoreapp < 版 本 号 > 
子 目录 ,可 以 看 到 名 为 test_2 的 目录 。 


注意 : 考虑 到 各 个 平台 中 文件 系统 的 差异 ,一 般 建 议 跨 平台 应 用 程序 使 用 相对 路 径 , 增 强 应 
用 程序 的 通用 性 。 
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实例 250 ”通过 ReadAllLines 方法 读 取 文 件 中 的 所 有 行 


【导语 】 

ReadAllLines 方法 一 般 用 于 读 取 文本 文件 , 它 可 以 将 文件 中 的 所 有 文本 行 读 出 来 ,并 
将 每 一 行 作为 一 个 元 素 存 入 string 数组 中 ,被 读 出 的 每 一 行 字 符 都 会 自动 去 掉 换行 符 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 应 用 程序 项 目 所 在 日 录 下 找到 \bin\Debug\netcoreapp < 版 本 号 > 子 目 录 , 在 
该 子 日 录 下 新 建 一 个 文件 ,并 使 用 文本 编辑 工具 往 文件 中 输入 几 行 文本 ,例如 在 Windows 
平台 上 ,可 以 使 用 记事 本 来 输入 内 容 并 保存 。 

保存 文件 时 注意 选择 文件 的 编码 为 UTF-8( 如 图 8-7 所 示 ) ,这 样 应 用 程序 在 读 取 文本 
时 不 会 读 出 乱码 。 


文件 名 (N): ltest.txt 
保存 类 型 (D): 文本 文档 (*.txt) 


入 隐藏 文件 夹 编码 (5): IUTF-8 ~ 保存 (5) 
ANSI 


Unicode 
图 8-7 文本 文件 以 UTF-8 编码 保存 


步骤 3: 回 到 Visual Studio 开发 环境 ,在 Main 方法 中 声明 一 个 字符 串 变量 ,用 于 存放 
待 访问 的 文件 名 , 即 刚才 所 保存 的 文本 文件 的 名 字 。 


string fileName = "test.txt"; 


步骤 4: 读 出 文件 中 的 所 有 行 。 


CProgr.. — 0O x 
string[ ] lines = File.ReadAllLines(fileNanme); = 


步骤 5: 输出 读 取 的 各 行 字符 。 


foreach (string line in lines) 
{ 
Console. WriteLine( line); 


} 图 8-8 ”从 文件 中 读 出 的 文本 行 


步骤 6: 运行 应 用 程序 , 读 出 的 文本 如 图 8-8 所 示 。 
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实例 251 依据 文件 的 大 小 排序 


【导语 】 

本 实例 整合 了 文件 操作 与 LINQ 查询 相关 的 知识 点 。 

访问 FileInfo 类 的 实例 属性 Length, 可 以 以 字 节 为 单位 获取 当前 文件 的 大 小 。 在 
LINQ 语句 中 ,可 以 使 用 orderby 子 句 并 以 Length 属性 为 依据 进行 排序 ,最 后 以 二 元 组 的 
形式 返回 查询 结果 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 编写 一 个 名 为 MakeFiles 的 静态 方法 ,该 方法 的 作用 是 产生 
20 个 随机 大 小 的 文件 , 稍 后 可 用 于 测试 。 


static void MakeFiles() 
{ 
Random rand = new Random( ); 
for(int x = 0; x< 20; x++) 
{ 
// 随机 产生 字 节 数 
int bufferLen = rand. Next(10, 99999); 
// 创建 字 节 数组 
byte[ ] buffer = new byte[bufferLen]; 
// 用 随机 字 节 填充 数组 
rand. NextBytes(buffer); 
// 创建 新 文件 ,并 写 人 内 容 
using(FileStream fs = File.Create("demo " + (x + 1))) 
{ 
fs. Write(buffer); 
} 


} 
步骤 3: 在 Main 方法 中 ,调用 MakeFiles 方法 来 生成 随机 文件 。 
MakeFiles( ); 

步骤 4: 实例 化 DirectoryInfo 类 ,目标 目录 为 当前 应 用 程序 所 在 的 目录 。 
DirectoryInfo dir = new DirectoryInfo("./"); 

步骤 5: 使 用 LINQ 语句 查询 ,并 按 文 件 大 小 排序 。 


var q = from f in dir.EnumerateFiles("demo_ *") 


orderby f. Length 
select (FileName: f.Name, FileSize: f.Length); 


此 处 使 用 EnumerateFiles 方法 罗列 当前 目录 下 的 子 文件 而 非 GetFiles 方法 ,因为 
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EnumerateFiles 方法 更 适用 于 查询 操作 ,此 方法 不 必 等 待 所 有 文件 扫描 完成 后 再 返回 ,从 调 
用 方法 开始 就 会 返回 找到 的 文件 ,所 以 能 提升 查询 的 效率 。 
步骤 6: 输出 查询 结果 。 


foreach (var i in q) 


{ 
Console. WriteLine( $ "文件 : {i. FileName}, 大 小 : 
{i.FileSize} 字 节 "); 
} 
步骤 7: (此 步骤 可 选 ) 打 开 项 目 属性 窗口 ,切换 到 
“生成 事件 ”选项 页 ,在 “生成 前 事件 命令 行 " 中 输入 以 
下 命令 : 


del $ (OutDir)\\demo_* 


这 样 可 以 在 重新 生成 项 目的 时 候 删 除 测试 所 用 的 
文件 。$ (OutDir) 宏 表示 应 用 项 目的 输出 目录 ,默认 
是 项 目 目 录 下 的 \bin\Debug\netcoreapp < 版 本 号 > 子 图 8-9 按 大 小 排序 后 的 文件 列表 
目录 。 

步骤 8: 运行 应 用 程序 ,排序 后 的 结果 如 图 8-9 所 示 。 

实例 252” 枚 举 磁盘 驱动 器 

【导语 】 

DriveInfo 类 封装 了 与 磁盘 驱动 器 的 有 关 的 信息 ,如 卷 标 、 可 用 空间 、 根 目录 等 。 调 用 静 
态 的 GetDrives 方法 ,可 以 获取 当前 系统 中 的 驱动 器 列表 。 在 访问 驱动 器 信息 之 前 ,应 当先 
检查 一 下 IsReady 属性 ,只 有 当 该 属性 为 true 时 ,此 驱动 器 的 信息 才 有 效 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 静态 方法 GetDrives ,获取 驱动 器 列表 。 


DriveInfo[ ] drs = DriveInfo. GetDrives(); 
步骤 3: 通过 LINQ 语句 查询 出 IsReady 属性 为 true 的 驱动 器 信息 。 


var q = from d in drs 
where d. IsReady 
select d; 


步骤 4: 输出 驱动 器 信息 。 


foreach (var di in q) 
{ 
Console. WriteLine( $ "驱动 器 名 :{di. Name}"); 
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Console. WriteLine( $ " 卷 标 :{di. VolumeLabel}"); 

Console. WriteLine( $ "总 容量 : {di. TotalSize}"); 

Console. WriteLine( $ "当前 可 用 空间 :{di. TotalFreeSpace}"); 
Console. WriteLine( $ "驱动 器 类 型 :{di. DriveType}"); 
Console. WriteLine( $ "文件 格式 : {di. DriveFormat}"); 
Console. WriteLine( $ " 根 目录 :{di. RootDirectory. Name}"); 
Console. Write("\n"); 


} 
步骤 5: 运行 应 用 程序 ,输出 结果 如 图 8-10 所 示 。 


CProgramfiles\dotnet.. 一 ODO Xx 


图 8-10 ”了 驱动 器 信息 


实例 253 ”向 内 存 流 写 人 内 容 


【导语 】 

流 ,是 输入 /输出 操作 中 很 常用 的 一 种 类 型 , 它 表示 数据 内 容 的 字 节 按照 顺序 进行 排列 。 

读 写 流 中 的 字 节 时 , 既 可 以 按照 其 排列 的 顺序 来 处 理 , 也 可 以 随意 移动 读 写 的 指针 位 置 ,以 
完成 更 复杂 的 输入 /输出 操作 。 
内 存 流 , 即 从 内 存 中 划分 出 一 个 特定 区 域 ,应 用 程序 可 以 将 字 节 序列 存放 到 这 个 区 域 
中 。 内 存 流 很 适合 用 于 读 写 临 时 数据 ,因为 它 不 用 处 理 磁盘 上 的 文件 ,可 以 直接 在 内 存 中 完 
成 相关 处 理 , 速 度 快 ,而 且 用 完 之 后 可 以 马上 释放 内 存 资源 。 对 于 不 需要 长 久保 存 的 内 容 ， 
特别 适合 在 内 存 流 中 读 写 。 

MemoryStream 类 封装 了 一 系列 操作 内 存 流 的 方法 。 所 有 与 流 相关 的 类 型 都 实现 了 
IDisposable 接口 ,以 便于 在 使 用 完 之 后 可 以 释放 其 占用 的 资源 。 比 较 优雅 的 一 种 做 法 是 : 
把 流 对 象 的 实例 放 在 using 语句 块 中 ,在 执行 完 using 语句 块 后 会 自动 释放 实例 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 声明 一 个 字 节 数组 ,并 进行 赋值 。 
byte[ ] buffer = { 155, 16, 3, 200, 77, 9, 21, 34, 60 }; 
步骤 3: 在 using 代码 块 中 创建 MemoryStream 实例 。 


using(MemoryStream stream = new MemoryStream( ) ) 


步骤 4: 将 刚才 创建 的 字 节 数组 写 入 到 内 存 流 中 。 


using(MemoryStream stream = new MemoryStream()) 


// 写 人 内 容 


stream. Write(buffer); 
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注意 : 在 Stream 类 中 ,接受 byte[] 类 型 参数 的 Write 方法 声明 如 下 。 


void Write(byte[ ] buffer, int offset, int count); 
而 本 实例 中 实际 使 用 的 为 如 下 重 载 版 本 。 


void Write(ReadOnlySpan < byte > buffer); 


该 方法 接受 的 参数 类 型 是 ReadOnlySpan <byte>, 之 所 以 可 以 直接 把 byte[ ] 类 型 的 
实例 传递 给 buffer 参数 ,是 因为 ReadOnlySpan 结构 定义 了 隐 式 转换 ,数组 类 型 实例 
可 以 直接 赋值 给 ReadOnlySpan 类 型 的 变量 , 隐 式 转换 的 声明 如 下 。 


static implicit operator ReadOnlySpan <T>(T[] array); 


实例 254 将 内 存 流 中 的 内 容 转换 为 字 节 数组 
【导语 】 


MemoryStream 类 公开 了 ToArray 方法 ,能 够 将 内 存 流 中 所 包含 的 内 容 转换 为 字 节 
数组 。 


【操作 流程 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 声明 一 个 字 节 数组 变量 , 稍 后 用 于 接收 从 内 存 流 中 转换 的 内 容 。 


byte[ ] data = null; 


步骤 3: 创建 内 存 流 实例 ,并 向 其 中 写 入 20 个 随机 生成 的 字 节 。 


using (MemoryStream stream = new MemoryStream( ) ) 


308 硬 .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


// 用 于 产生 随机 字 节 

Random rand = new Random(); 
// 写 和 人 20 字 节 

byte[ ] buffer = new byte[20]; 
rand. NextBytes( buffer); 
stream. Write(buffer); 


步骤 4: 随后 调用 内 存 流 实例 的 ToArray 方法 ,获取 字 节 数组 。 


using (MemoryStream stream = new MemoryStream( ) ) 


// 从 流 中 重新 提取 字 节 数组 


data = stream. ToArray(); 


步骤 5: 在 控制 台中 输出 从 内 存 流 中 提取 的 字 节 序列 。 
Console. WriteLine(BitConverter,ToString(data) ); 图 8-11 从 内 存 流 中 提 


取 的 字 节 序列 
步骤 6: 运行 应 用 程序 ,得 到 的 结果 如 图 8-11 所 示 。 


实例 255 ”从 内 存 流 中 读 取 内 容 


【导语 】 
本 实例 演示 了 Read 方法 的 使 用 , 它 的 声明 如 下 : 


int Read(byte[ ] buffer, int offset, int count); 


buffer 参数 是 一 个 字 节 数组 ,用 来 存放 读 出 来 的 字 节 。offset 参数 指定 数组 中 开始 存 人 读 
出 字 节 的 位 置 索引 , 即 从 buffer 数组 的 哪个 位 置 开 始 写 入 读 到 的 数据 ,此 索引 是 从 0 开始 计 
算 的 。count 参数 指定 要 从 流 中 读 入 的 字 节 的 最 大 数量 。Read 方法 的 返回 值 表 示 实 际 读 取 
的 字 节 数量 ,如 果 流 中 剩余 的 字 节 小 于 count 参数 指定 的 数量 , 则 Read 方法 所 返回 的 数量 
会 小 于 count 参数 所 指定 的 数量 ; 如 果 已 经 到 了 流 的 末尾 ,无 可 用 字 节 , 则 Read 方法 返 
可 0 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 定义 一 个 GetStream 方法 ,用 于 创建 内 存 流 实例 并 向 流 中 写 
入 字 节 序列 。 

static MemoryStream GetStream( ) 


{ 


MemoryStream ms = new MemoryStream(); 
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// 写 人 5 字 节 

ms. WriteByte(1); 
ms. WriteByte(2); 
ms. WriteByte(3); 
ms. WriteByte(4); 
ms. WriteByte(5); 
// 将 读 写 指针 复位 
ms. Position = 0L; 
return ms; 


} 
步骤 3: 在 Main 方法 中 ,调用 GetStream 方法 获取 流 实例 的 引用 ,并 写 入 using 语句 块 


using(MemoryStream stream = GetStream()) 


步骤 4: 从 流 中 读 取 刚刚 写 入 的 字 节 序列 。 
using(MemoryStream stream = GetStream() ) 


byte[ ] buffer = new byte[ stream.Length]; 
stream. Read( buffer, 0, buffer. Length); 
Console. WriteLine( $ " 读 出 的 字 节 :\n{BitConverter. ToString(buffer)}"); 


步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 


读 出 的 字 节 : 
01-02-03-04-05 


实例 256 ”使 用 StreamWriter 类 将 文本 写 人 文件 


【导语 】 

StreamWriter 类 继承 了 TextWriter 类 , 它 是 专门 为 写 入 文本 内 容 而 设计 的 。 
StreamWriter 类 支持 以 流 的 形式 将 内 容 写 入 文件 ,虽然 它 允 许 写 入 如 bool ,int decimal、 
float、object 等 数据 类 型 的 内 容 , 但 最 终 会 以 文本 的 形式 写 入 文件 中 (如 同调 用 了 写 入 对 象 
的 ToString 方法 )。 

StreamWriter 类 默认 使 用 UTF-8 编码 格式 来 写 入 文本 ,如 需 改 用 其 他 编码 格式 ,可 以 
调用 带 有 System. Text. Encoding 类 型 参数 的 构造 函数 ,例如 以 下 形式 。 


StreamWriter(System. I0. Stream, System. Text. Encoding) 


写 人 内 容 的 时 候 , 可 以 调用 Write 方法 或 者 WriteLine 方法 ,两 种 方法 功能 相近 ,只 是 
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WriteLine 方法 会 自动 在 写 人 的 内 容 后 面 追加 换行 符 。 

StreamWriter 类 可 以 应 用 于 各 种 类 型 的 流 ,例如 内 存 流 、 文 件 流 等 。 如 果 调 用 的 是 带 
string 类 型 参数 的 构造 函数 , 则 可 以 直接 指定 文件 名 ,StreamWriter 类 会 把 文本 内 容 直 接 输 
出 到 文件 中 。 

【操作 流程 】 

步骤 1: 新建 控 制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Main 方法 中 ,创建 StreamWriter 实例 ,要 写 入 的 文件 名 为 


abc. txt。 


using (StreamWriter writer = new StreamWriter("abc.txt")) 


} 
步骤 3: 依次 写 人 以 下 数据 类 型 的 内 容 : int、decimal、string、bool、DateTime。 


using (StreamWriter writer = new StreamWriter("abc.txt")) 
{ 
writer. WriteLine( 300); 
writer. Write(0.335M); 
writer. Write("test"); 
writer. WriteLine(false); 


writer. Write(DateTime. Today); 


文件 () ”编辑 (E) 格式 (O) 查看 (V) 帮助 (H) 


} 00 “ 
0. 335testFalse 

步骤 4: 运行 应 用 程序 。 2018-7-31 0:00:00 

步骤 5: 待 程序 执行 完成 后 ,找到 应 用 程序 所 在 的 > 


目录 ,打开 abc. txt 文件 ,能 看 到 已 写 和 该 文本 文件 的 内 图 8-12 写 入 到 文本 文件 中 的 内 容 
容 , 如 图 8-12 所 示 。 


实例 257 使 用 StreamReader 类 读 取 文本 文件 


【导语 】 

与 StreamWriter 类 相对 应 ,框架 提供 了 一 个 StreamReader 类 ,用 于 以 文本 形式 读 取 流 
中 的 内 容 。 

常用 的 读 取 方法 如 下 。 

(1) Read 方法 : 可 以 读 取 一 个 字符 ,以 int 类 型 返回 ,可 以 转换 为 char 类 型 ; 此 方法 的 
其 他 重 载 支持 读 取 多 个 字符 ,结果 存储 在 char 数组 中 。 

(2) ReadLine 方法 : 每 次 读 取 一 行 。 

(3) ReadToEnd 方法 : 一 次 性 读 取 所 有 文本 。 

在 读 取 流 的 时 候 , 有 两 种 方法 可 以 判断 读 取 指 针 是 否 已 经 到 了 流 的 末尾 (到 了 流 的 末尾 
就 无 法 读 取 有 效 的 内 容 了 ): 
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第 一 种 是 调用 Peek 方法 。 该 方法 会 提取 下 一 个 字符 ,但 不 会 执行 读 取 , 如 果 没 有 可 用 
字符 ,方法 返回 一 1, 以 此 判断 读 取 指 针 已 经 到 了 流 的 末尾 。 

第 二 种 方法 是 检查 Read 或 ReadLine 方法 的 返回 值 。 对 于 ReadLine 方法 ,如 果 返 回 
null ,说 明 没有 可 读 取 的 内 容 了 。 对 于 Read 方法 ,如 果 读 不 到 有 效 字符 ,会 返回 一 1 。 

本 实例 首先 将 四 行文 本 写 入 文件 ,随后 使 用 StreamReader 类 逐 行 读 出 文本 ,并 输出 到 
控制 台 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 定义 WriteSomethingToFile 方法 ,用 于 将 文本 写 入 文件 。 


static void WriteSomethingToFile() 
{ 


using(StreamWriter writer = new StreamWriter("demo. txt")) 
{ 

writer.WriteLine("first line"); 

writer. WriteLine(5000000L); 

writer. WriteLine(0.000075d); 

writer. WriteLine(6600); 


} 


步骤 3: 在 Main 方法 中 ,调用 WriteSomethingToFile 方法 写 人 文件 。 
步骤 4: 调用 WriteSomethingToFile 方法 后 ,实例 化 StreamReader 类 ,从 文件 中 读 取 
内 容 ( 逐 行 读 取 , 并 向 控制 台 输出 )。 


using(StreamReader reader = new StreamReader("demo.txt")) 
{ 
string line = null; 
while((line = reader.ReadLine()) != null) 
Console. WriteLine(line); 
} 
} 


步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 


first line 
5000000 
7.5E—05 
6600 


实例 258 ”调用 Seek 方法 重新 设置 流 的 当前 位 置 


【导语 】 
在 读 写 流 中 的 内 容 时 ,在 需要 的 情况 下 可 以 修改 流 的 当前 位 置 。Seek 方法 可 以 调整 流 
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的 当前 读 写 位 置 。Seek 方法 的 第 一 个 参数 是 新 的 位 置 , 如 果 位 置 向 流 的 结尾 移动 , 则 新 的 
位 置 为 正 值 ; 反之 ,如 果 位 置 向 流 的 开头 移动 , 则 应 为 负 值 。Seek 方法 的 第 二 个 参数 是 指 
定 新 位 置 的 参考 点 ,由 SeekOrigin 枚 举 指定 , 它 包 含 以 下 三 个 可 用 值 。 

(1) Begin: 新 位 置 以 流 的 开头 为 参考 。 

(2) Current: 新 位 置 以 流 的 当前 位 置 为 参考 。 

(3) End: 新 位 置 是 相对 于 流 的 结尾 而 设 定 的 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 内 存 流 实例 ,并 将 实例 化 过 程 写 在 using 代码 块 中 。 


using(MemoryStream ms = new MemoryStream()) 


步骤 3: 向 流 中 写 和 人 8 字 节 。 
for(byte x = 1; x<= 8; x++) 


ms. WriteByte(x); 
Console. Write(" Ox{0:x2}", x); 


步骤 4: 将 流 的 当前 位 置 ( 读 写 指针 ) 调 整 到 倒数 第 三 个 字 节 处 。 由 于 位 置 是 相对 于 流 
的 尾部 的 ,因此 位 置 索引 为 一 3。 
ms. Seek( — 3, SeekOrigin. End); 


步骤 5: 从 新 位 置 开始 逐个 字 节 读 取 , 直 到 流 的 结尾 。 


int r; 
while ((r = ms.ReadByte()) > -1) 
{ 

Console. Write(" Ox{0:x2}", r); 
} 


步骤 6: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 8-13 所 示 。 


CProgram Files\dotnet\domnet.exe - OO x 
入 汪 的 于 下 


图 8-13 读 出 流 中 最 后 3 字 节 
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实例 239 通过 Position 属性 更 改 流 的 当前 位 置 


【导语 】 
要 设置 流 的 当前 位 置 , 除 了 使 用 Seek 方法 外 ,还 可 以 直接 设置 Position 属性 。 该 属性 
的 值 是 从 0 开始 计算 的 , 即 0 表示 流 的 开始 位 置 。 
【操作 流程 】 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 将 随机 产生 的 字 节 序列 写 人 文件 。 
using(FileStream fs = new FileStream("demo", FileMode. OpenOrCreate)) 
| Random rand = new Random( ) ; 
byte[ ] data = new byte[10]; 
rand. NextBytes(data); 
fs, Write(data); 
} 


步骤 3: 从 该 文件 中 读 出 最 后 5 字 节 。 


using(FileStream fs = new FileStream("demo", FileMode. Open)) 
{ 

// 重新 设 定 当前 位 置 

fs. Position = 5L; 

byte[ ] buffer = new byte[fs.Length — fs.Position]; 

// 读 入 字 节 

fs. Read(buffer, 0, buffer. Length); 

// 输出 结果 

Console. WriteLine( $ "文件 中 的 最 后 5 字 节 为 :\n{BitConverter. ToString(buffer)}"); 
' 


Position 属性 的 值 是 以 0 为 基础 的 ,从 第 6 个 字 节 开始 读 取 , 当 前 位 置 应 设 定 为 5。 
步骤 4: 运行 应 用 程序 ,输出 的 结果 如 下 。 

文件 中 的 最 后 5 字 节 为 : 

17-88-25- C0-7B 


8.3 压缩 与 解压 缩 


实例 260 使 用 DeflateStream 类 压缩 文件 

【导语 】 

在 System. IO. Compression 命名 空间 下 ,框架 已 经 封装 了 一 组 常用 的 类 ,用 于 对 流 进 
行 压缩 和 解压 缩 ,这 些 类 的 操作 方法 与 流 相 似 (毕竟 它们 都 是 从 Stream 类 派生 出 来 的 ) 。 
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本 实例 使 用 压缩 功能 类 DeflateStream. 它 采用 Deflate 压缩 标准 算法 ,属于 huffman 编 
码 的 增强 版 。 框 架 内 部 默认 通过 zlib 实现 DeflateStream 类 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 接收 用 户 输入 ,分 别 收 集 待 压 缩 文件 的 路 径 和 压缩 后 文件 的 输出 路 径 。 

Console. WriteLine(" 请 输入 待 压缩 文件 的 完整 路 径 :"); 

string inputFilePath = Console. ReadLine(); 

Console. WriteLine(" 请 输入 压缩 后 文件 的 输出 路 径 :"); 

string outputFilePath = Console. ReadbLine(); 

ReadLine 方法 将 从 控制 台 读 取 用 户 输入 的 一 行文 本 ,以 用 户 按 下 Enter 来 确认 。 

步骤 3: 对 输入 文件 进行 压缩 。 

using (FileStream instream = new FileStream(inputFilePath, FileMode. Open)) 

using (FileStream outstream = new FileStream(outputFilePath, FileMode. Create)) 

using (DeflateStream defstream = new DeflateStream(outstream, CompressionLevel.Optimal)) 

{ 

instream. CopyTo( defstream); 

} 

在 实例 化 DeflateStream 类 时 ,需要 绑 定 一 个 基础 流 实例 ,随后 会 将 压缩 好 的 数据 写 人 
到 这 个 流 中 ,此 处 以 输出 文件 流 为 写 信 目标。CopyTo 方法 可 以 完成 流 与 流 之 间 简 单 的 数 
据 传递 , 它 直 接 把 输入 文件 流 中 的 所 有 字 节 序列 复制 到 目标 流 中 。 

步骤 4: 执行 完 文件 压缩 后 ,分 别 输出 两 个 文件 的 大 小 ,以 观察 压缩 效果 。 

FileInfo fl = new FileInfo(inputFilePath)，f2 = new FileInfo(outputFilePath); 

Console. WriteLine( $ "压缩 前 文件 大 小 :{f1. Length}"); 

Console. WriteLine( $ "压缩 后 文件 大 小 :{f2. Length}"); 

步骤 5: 运行 应 用 程序 ,依次 输入 待 压缩 文件 与 压缩 后 文件 的 路 径 , 按 下 Enter 键 确认 
后 会 输出 压缩 前 后 的 文件 大 小 ,如 图 8-14 所 示 。 


国 CNprogram Flesvdotnetdot。 一 


图 8-14 文件 压缩 前 后 的 大 小 对 比 


注意 : 并 非 所 有 文件 都 能 产生 较 高 的 压缩 比 , 某 些 特殊 文件 在 压缩 后 反而 会 增 大 ,但 增 大 的 
幅度 较 小 。 


实例 261 
【导语 】 
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创建 Zip 压缩 文档 


ZipArchive 类 支持 对 zip 压缩 文档 的 基本 管理 ,压缩 文档 中 的 每 个 文件 (实体 ) 由 
ZipArchiveEntry 类 进行 维护 。 调 用 ZipArchiveEntry 实例 的 Delete 方 法 可 以 将 文件 从 zip 文档 


中 删除 ; 调用 Open 方法 将 得 到 一 个 流 实例 ,可 以 对 压缩 文档 中 的 文件 实体 进行 读 写 操作 。 


本 实例 将 完成 两 项 操作 : 首先 创建 一 个 zip 压缩 文档 ,并 向 该 文档 添加 三 个 文件 实体 ， 
每 个 实体 都 写 信 内容。 然后 将 该 压缩 文档 中 的 文件 实体 解压 出 来 ,分 别 存储 到 三 个 文本 文 


件 中 。 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 string 类 型 的 变量 ,存放 文件 名 。 


string zipFile = "demo.,zip"; 


步骤 3: 创建 zip 压缩 文档 ,并 存 人 三 个 实体 , 详 见 代码 清单 8-1。 


代码 清单 8-1 在 新 zip 压缩 文档 中 存 入 三 个 实体 


using (FileStream outfs = File. Create(zipFile)) 


{ 


using (ZipArchive zip = new ZipArchive(outfs, ZipArchiveMode. Create) ) 


羽 莫 一 企 文 作 
ZipArchiveEntry etl = zip.CreateEntry("docs/docl. txt"); 
using (Stream stream = etl.Open()) 
i 
using (StreamWriter writer = new StreamWriter(stream)) 
{ 
writer. Write( "示例 文档 A"); 
} 
} 
// 第 二 个 文件 
ZipArchiveEntry et2 = zip.CreateEntry("docs/doc2. txt"); 
using (Stream stream = et2.0pen()) 
{ 
using (StreamWriter writer = new StreamWriter(stream)) 
{ 
writer. Write(" 示 例文 档 B"); 
} 
} 
XW/ 第 三 个 文件 


ZipArchiveEntry et3 = zip.CreateEntry("docs/doc3. txt"); 
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using (Stream stream = et3.0pen()) 
{ 
using (StreamWriter writer = new StreamWriter(stream)) 
writer. Write( "示例 文档 C"); 
} 


注意 : 若 要 创建 新 的 压缩 文档 ,在 调用 ZipArchive 类 的 构造 函数 时 ,不 仅 要 提供 基础 文件 的 
流 , 还 要 将 mode 参数 指定 为 ZipArchiveMode. Create ,否则 会 发 生 异常 。 
调用 CreateEntry 方法 时 指定 的 实体 名 称 ,允许 使 用 相对 路 径 。 


步骤 4: 将 已 创建 的 zip 压缩 文档 中 的 三 个 实体 解压 出 来 ,并 存 到 文本 文件 中 。 详 见 代 
码 清单 8-2 。 
代码 清单 8-2 解压 文档 中 的 实体 


using(FileStream instream = File.OpenRead(zipFile)) 
{ 
using(ZipArchive zip = new Ziphrchive( instream)) 
foreach(ZipArchiveEntry et in zip. Entries) 
{ 
using(Stream stream = et.Open()) 
{ 


using(FileStream fsout = File.Create(et. Name)) 


ff 
Stream. CopyTo( fsout); 
} 


} 


步骤 5: 运行 应 用 程序 。 

步骤 6: 应 用 程序 执行 完成 后 ,在 应 用 程序 所 在 的 目录 下 ,会 看 到 被 解压 出 来 的 三 个 文 
本 文件 ,如 图 8-15 所 示 。 

实例 262 使 用 GZipStream 类 压缩 文件 

【导语 】 

GZIP( 全 称 GNUzip) 最 早 由 Jean-loup Gailly 和 Mark Adler 开发 ,用 于 Unix 系统 的 文 
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国 docibt - 记事 本 一 口 -3 
文件 ( 虽 。 编 弓 (E) 格式 (O) 查看 V) 帮助 (H) 
示例 文档 A 
网 doc2tdt -记事 本 一 口 x 
文件 (第 和 (E) 站 式 (0) 过 看 V) 帮助 (H) 
示例 文档 B 
文中 编 结 (E) 格式 (O) 查看 (V) 帮助 (H) 
示例 文档 C A 


图 8-15 解压 后 的 三 个 文本 文件 


件 压缩 ,通常 文件 扩展 名 为 . gz, 是 非常 普遍 的 一 种 数据 压缩 格式 ,或 者 说 是 一 种 文件 格式 。 
框架 以 GZipStream 类 来 封装 GZip 算法 相关 功能 ,使 用 方法 与 DeflateStream 相同 。 

本 实例 将 提示 用 户 输入 待 压缩 文件 的 路 径 ,确认 后 使 用 GZip 算法 压缩 文件 ,并 在 应 用 
所 在 目录 下 输出 名 为 demo. gz 的 文件 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 获取 用 户 输入 的 待 压缩 文件 路 径 。 


Console. WriteLine(" 请 输入 待 压 缩 文件 的 路 径 :"); 
string inFilePath = Console. ReadLine(); 


步骤 3: 声明 一 个 string 类 型 的 变量 ,表示 输入 的 压缩 文件 名 。 
string outFileName = "demo.gz"; 
步骤 4: 对 输入 文件 进行 压缩 处 理 。 


using (FileStream fsIn = File.OpenRead( inFilePath)) 
using (FileStream fsOut = File.Create(outFileName)) 
{ 
using (GZipStream gz = new GZipStream(fsOut, CompressionMode. Compress)) 
{ 
fsIn. CopyTo(gz); 
} 
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步骤 5: 分 别 输出 压缩 前 后 的 文件 大 小 ,以 供 对 比 。 


FileInfo infol = new FileInfo(inFilePath); 

FileInfo info2 = new FileInfo(outFileName); 

Console. WriteLine ( $ "压缩 前 ,文件 大 小 : { infol. 
Length}"); 

Console. WriteLine ( $ "压缩 后 , 文件 大 小 : { info2. 
Length}"); 


步骤 6: 运行 应 用 程序 ,输出 内 容 如 图 8-16 所 示 。 
8.4 ”内 存 映射 文件 


实例 263 读 写 内 存 映 射 文件 


【导语 】 

内 存 映 射 文件 ,其 实 是 在 应 用 程序 内 存 空间 中 划分 的 一 块 特殊 内 存 ,可 以 像 操 作 磁盘 文 
件 那 样 ,在 内 存 中 新 建文 件 ,并 写 人 或 读 取 内 容 。 

在 内 存 中 不 仅 可 以 读 写 文件 ,内 存 映 射 文件 还 可 以 从 磁盘 文件 中 提取 内 容 , 映 射 到 内 存 
空间 中 进行 操作 。 这 对 于 大 型 文件 的 读 写 尤为 重要 ,应 用 程序 不 需要 将 整个 文件 都 加 载 到 
内 存 中 ,而 是 映射 文件 中 的 "一 段 ? 数 据 , 可 以 大 大 提升 效率 。 

内 存 映射 文件 也 可 以 用 于 在 进程 之 间 共 享 数据 。 例 如 ,A 进程 创建 了 文件 1. data 并 写 
入 数据 ,然后 B 进程 可 以 从 1. data 文件 中 读 取 刚刚 写 入 的 数据 。 

在 内 存 区 域 中 创建 的 文件 不 需要 显 式 删除 , 当 引 用 该 内 存 的 最 后 一 个 进程 退出 时 ,内 存 
中 的 数据 就 会 被 清理 并 由 系统 回收 。 

本 实例 简单 演示 了 如 何在 内 存 中 创建 文件 ,并 在 同一 个 进程 中 写 入 和 读 取 内 容 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 CreateNew 项 态 方法 创建 新 的 内 存 文 件 。 


MemoryMappedFile file = MemoryMappedFile.CreateNew("test", 200L); 


步骤 3 向 内 存 文件 写 人 一 行文 本 。 


图 8-16 用 GZip 算 法 压缩 文件 


using (var mvstream = file.CreateViewStream( ) ) 
t 
using (StreamWriter writer = new StreamWriter(mvstream)) 
{ 
writer. WriteLine(" 你 好 ,这 是 一 行文 本 。"); 
} 
} 


调用 CreateViewStream 方法 可 以 获得 一 个 MemoryMappedViewStream 实例 ,并 通过 
流 来 读 写 文 件 。 
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步骤 4: 读 取 写 人 内 存 文件 的 文本 。 


using (MemoryMappedFile mfile = MemoryMappedFile.OpenExisting("test")) 
{ 
using (var vstream = mfile.CreateViewStream()) 
{ 
using (StreamReader reader = new StreamReader(vstream)) 
人 
string str = reader. ReadLine(); 
Console. WriteLine( str); 


} 


对 于 已 经 存在 的 内 存 文 件 , 应 该 调用 OpenExisting 静态 方法 来 获得 
MemoryMappedFile 实例 的 引用 。 


注意 : 调用 CreateNew 方法 创建 的 MemoryMappedFile 实例 ,在 写 入 完 数 据 后 ,不 要 立即 释 
放 资 源 。 由 于 本 实例 的 读 写 操作 都 是 在 同一 个 进程 中 执行 的 ,如 果 写 完 数据 后 就 释 
放 实 例 ,系统 检测 不 到 对 内 存 文件 的 其 他 引用 ,新 创建 的 内 存 文件 就 会 被 回收 ,就 无 
法 读 取 之 后 的 代码 了 。 


实例 264 ”将 内 存 映射 文件 写 人 磁盘 文件 

【导语 】 

内 存 映 射 文件 是 存在 于 内 存 中 的 ,一 旦 访问 该 内 存 区 域 的 所 有 进程 都 退出 ,内 存 中 的 数 
据 就 会 被 回收 ,文件 内 容 就 丢失 了 。 因 此 有 必要 将 内 存 映射 文件 与 磁盘 文件 关联 ,这 样 当 内 
存 中 的 数据 被 回收 时 ,会 将 这 些 数据 自动 写 入 到 磁盘 文件 中 ,可 持久 存储 。 

要 建立 内 存 文件 与 磁盘 文件 之 间 的 映射 关系 ,在 获得 MemoryMappedFile 实例 时 ,应 
该 调用 静态 的 CreateFromFile 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 CreateFromFile 方法 ,建立 内 存 文件 与 磁盘 文件 之 间 的 映射 关系 。 


using (MemoryMappedFile mmfile = MemoryMappedFile. CreateFromFile ( " demo. data", FileMode. 
OpenOrCreate, "demo", 100L)) 

} 
此 处 调用 的 是 以 下 重 载 版 本 的 CreateFromFile 方法 。 


MemoryMappedFile CreateFromFile(string path, FileMode mode, string mapName, long capacity); 


path 参数 指定 磁盘 上 文件 的 路 径 ,mapName 参数 指定 建立 映射 关系 后 内 存 文件 的 名 
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字 。 注 意 ,本 实例 中 需要 为 capacity 参数 明确 指定 一 个 数值 ,该 数值 为 映射 文件 的 最 大 容 
量 , 因 为 磁盘 上 的 文件 原先 并 不 存在 ,是 在 内 存 文件 中 写 和 数据 后 再 保存 到 磁盘 文件 上 的 ， 
所 以 必须 指明 capacity 参数 ,否则 会 出 现 错 误 。 本 例 指 定 文件 的 大 小 为 100 字 节 ,不 论 实际 
写 人 了 多 少 字 节 , 最 终 产 生 的 磁盘 文件 的 大 小 都 是 100 字 节 。 

步骤 3: 依次 写 人 int\float\long ,double 四 个 数值 。 


using(var vstream = mmfile.CreateViewStream( )) 


using(BinaryWriter writer = new BinaryWriter(vstream)) 
{ 

writer, Write(160); 

writer. Write(1. 27f); 

writer,. Write(900000L); 

writer. Write(13.165d); 


: 


对 于 值 类 型 的 数据 ,使 用 BinaryWriter 类 来 写 入 比较 合适 ,因为 此 类 是 以 二 进 制 方式 
来 处 理 数据 的 。 
步骤 4: 从 生成 的 磁盘 文件 中 ,依次 读 出 这 四 个 数值 。 


using(FileStream stream = File.OpenRead("demo. data")) 
Console. WriteLine( $ "文件 的 大 小 为 :{stream. Length}"); 
using(BinaryReader reader = new BinaryReader(stream)) 
{ 
int vl = reader.ReadInt32(); 
float v2 = reader. ReadSingle(); 
long v3 = reader.ReadInt64(); 
double v4 = reader.ReadDouble(); 
Console. WriteLine( $ " 读 到 的 int 值 :{v1}"); 
Console. WriteLine( $ " 读 到 的 float 值 : {v2}"); 
Console.WriteLine( $ " 读 到 的 long 值 :{v3}"); 
Console. WriteLine( $ " 读 到 的 double 值 :{v4}"); 


注意 : 读 取 的 顺序 一 定 要 与 写 入 的 顺序 相同 ,才能 读 到 正确 的 值 。 


步骤 5: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 8-17 所 示 。 


® CProgram.. 一 口 x 


图 8-17 从 磁盘 文件 中 读 出 数据 


第 8 章 文件 与 /O | 321 


8.5 命名 管道 


实例 265 ”实现 本 地 进程 之 间 的 通信 

【导语 】 

命名 管道 是 一 种 比较 简单 易 用 的 通信 方式 , 它 支 持 同 一 台 计 算 机 上 进程 与 进程 之 间 ,或 
者 不 同 计算 机 上 进程 与 进程 之 间 的 数据 传输 。 要 使 用 命名 管道 进行 进程 间 的 通信 ,需要 用 
到 System. IO. Pipes 命名 空间 中 的 以 下 两 个 类 。 

(1) NamedPipeServerStream 类 : 通信 中 的 服务 器 ,实例 化 该 类 型 之 后 ,需要 调用 
WaitForConnection 方法 或 者 WaitForConnectionAsync 方法 来 侦 听 客户 端 连接 。 

(2) NamedPipeClientStream 类 : 通信 中 的 客户 端 ,实例 化 该 类 型 后 ,调用 Connect 方 
法 可 以 向 服务 器 发 起 连接 请 求 。 

NamedPipeServerStream 类 与 NamedPipeClientStream 类 都 是 Stream 的 派生 类 ,因此 
它们 都 可 以 以 流 的 方式 发 送 或 接收 数据 。 

本 实例 的 解决 方案 中 包含 两 个 应 用 程序 项 目 , 分 别 表示 通信 中 的 两 个 进程 。 当 两 个 应 
用 程序 启动 后 ,用 户 可 以 在 客户 端 通过 键盘 输入 消息 然后 发 送 , 服 务 器 会 显示 接收 到 的 
消息 。 

【操作 流程 】 

首先 实现 服务 器 应 用 程序 。 

步骤 1: 引入 以 下 命名 空间 。 


using Systenm; 
using System. I0; 
using System. I0. Pipes; 


步骤 2: 在 using 语句 块 中 实例 化 NamedPipeServerStream 类 。 


using(NamedPipeServerStream server = new NamedPipeServerStream("demo")) 


Li 


Console. WriteLine(" 按 任意 键 退 出 。"); 
Console. Read( ); 


} 


调用 NamedPipeServerStream 构造 函数 时 ,传递 一 个 自 定义 名 称 , 此 名 称 可 以 唯一 确 
定 该 服务 器 管道 。 
步骤 3: 等 待 客户 端的 连接 。 


server. WaitForConnection( ); 
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步骤 4: 使 用 StreamReader 类 来 读 取 从 客户 端 发 来 的 消息 。 


try 
{ 
using(StreamReader reader = new StreamReader(server)) 
{ 
string msg 
while( (msg 
{ 
Console. WriteLine( $ "客户 端 : {msg}"); 
} 


null; 
reader. ReadLine()) != null) 


} 
} 


catch 


{ 
Console. WriteLine(" 发 生 了 错误 。"); 
} 


接 下 来 实现 客户 端 应 用 程序 。 
步骤 5: 引入 以 下 命名 空间 。 


using Systenm; 
using System. I0; 
using System. I0. Pipes; 


步骤 6: 实例 化 NamedPipeClientStream 类 。 在 调用 构造 函数 时 ,传递 给 pipeName 参 
数 的 管道 名 称 必 须 与 服务 器 管道 的 名 称 匹配 ,否则 无 法 进行 连接 。 


using(NamedPipeClientStream client = new NamedPipeClientStream("demo" ) ) 
{ 


} 

步骤 7: 向 服务 器 发 出 连接 请 求 。 

client. Connect(); 

步骤 8: 使 用 StreamWriter 类 来 写 人 要 发 送 的 消息 。 


using(StreamWriter writer = new StreamWriter(client)) 
{ 
writer. AutoFlush = true; 
while(true) 
{ 
Console. WriteLine( "请 输入 要 发 送 的 内 容 :"); 
string msg = Console. ReadLine(); 
if (!string. IsNullOrWhiteSpace(msg)) 
{ 
writer. WriteLine(msg); 


E 


第 8 章 文件 与 /O | 323 


将 AutoFlush 属性 设置 为 true, 可 以 使 StreamWriter 实例 每 次 写 入 数据 后 自动 将 数据 
提交 到 基础 的 NamedPipeClientStream 实例 中 ,从 而 达到 立刻 发 送 消息 的 目的 。 

步骤 9: 在 Visual Studio 的 “解决 方案 资源 管理 器 ”窗口 中 , 右 击 解决 方案 名 称 , 从 快捷 
菜单 中 选择 属性 命令 ,打开 解决 方案 属性 窗口 。 

步骤 10: 在 启动 项 目 对 话 框 中 色 选 多 个 启动 项 目 , 然 后 将 服务 器 和 客户 端 两 个 应 用 程 
序 项 目 都 设置 为 启动 , 单 击 确定 按钮 保存 ,这 样 在 运行 时 就 可 以 同时 启动 两 个 项 目 , 如 
图 8-18 所 示 。 


O 〇 当前 过 定 内 容 (R) 

口 单 启动 页 目 G) 
Demoserver 

回 医 个 启动 页 目 (gj 


项 目 握 作 
DemoClient 启动 


DemoServer 启动 IC 


图 8-18 两 个 项 目 均 设置 为 启动 
步骤 11: 按 F5 快捷 键 同时 运行 两 个 项 目 。 


步骤 12: 在 客户 端 中 输入 要 发 送 的 消息 , 按 Enter 键 确认 ,在 服务 器 程序 中 就 会 看 到 已 
接收 的 消息 ,如 图 8-19 所 示 。 


图 8-19 服务 器 与 客户 端的 输出 文本 
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实例 266 ” 单 向 管道 通信 


【导语 】 

在 调用 NamedPipeServerStream 和 NamedPipeClientStream 类 的 构造 函数 时 ,可 以 传 
递 一 个 direction 参数 ,该 参数 类 型 是 PipeDirection 枚 举 ,用 来 指定 管道 的 通信 方向 , 它 定义 
了 以 下 三 个 值 。 

(1) Out: 管道 仅 为 输出 模式 , 即 只 能 写 和 消息。 

(2) In: 管道 仅 为 输入 模式 , 即 只 读 通信 。 

(3) InOut: 双向 通信 ,可 以 写 入 消息 ,也 可 以 读 取消 息 。 

当 未 指定 direction 参数 的 情况 下 ,默认 生成 双向 通信 的 管道 (InOut)。 

本 实例 将 实现 单 向 通信 ,服务 器 只 能 用 于 发 送 消息 ,而 客户 端 只 能 读 取消 息 。 

【操作 流程 】 

以 下 是 服务 器 的 实现 步骤 。 

步骤 1: 引入 以 下 命名 空间 。 

using System; 


using System. I0; 
using System. I0. Pipes; 


步骤 2: 实例 化 NamedPipeServerStream 类 。 


using(NamedPipeServerStream server = new NamedPipeServerStream("test", PipeDirection. Out)) 


{ 


} 


在 调用 构造 函数 时 ,明确 指定 direction 参数 为 Out。 
步骤 3: 等 待 客户 端 连接 。 


server. WaitForConnection( ); 
步骤 4: 使 用 StreamWriter 类 来 写 人 消息 。 


using(StreamWriter writer = new StreamWriter(server)) 
{ 
writer. AutoFlush = true; 
Console. ForegroundColor = ConsoleColor.Yellow; 
Console. WriteLine(" 注 意 :可 输入 "end" 退 出 。"); 
Console. ResetColor(); 
while (true) 
{ 
Console. Write(" 请 输入 要 发 送 的 消息 :"); 
string msg = Console. ReadLine(); 
if(msg. ToLower() == "end") 
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{ 
break; 
} 
writer. WriteLine(msg); 
server. WaitForPipeDrain( ); 


} 


为 了 可 以 发 送 多 条 消息 ,发 送 消息 的 代码 写 在 while 循环 中 , 当 输 入 的 内 容 为 “end” 时 
跳出 循环 。 发 送 消息 后 调用 一 次 WaitForPipeDrain 方法 ,可 以 使 服务 器 等 待 客户 端 收 到 消 
息 后 再 继续 发 送 后 续 的 消息 。 

以 下 是 客户 端的 实现 步 又。 

步骤 5: 引入 以 下 命名 空间 。 

using System; 


using System. IO; 
using System. I0. Pipes; 


步骤 6: 实例 化 NamedPipeClientStream 类 。 


using(NamedPipeClientStream client = new NamedPipeClientStream(".", "test", PipeDirection. 
In)) 
{ 


站 
该 代码 使 用 了 以 下 重 载 版 本 的 构造 函数 。 
NamedPipeClientStream( string serverName, string pipeName, PipeDirection direction) 


serverName 指定 远程 计算 机 名 称 ,由 于 本 例 是 在 本 机 进行 测试 ,此 参数 可 以 使 用 *. ”或 
“localhost”。direction 参数 为 In, 即 可 读 通 信 。 
步骤 7: 连接 服务 器 。 


client. Connect(); 
步骤 8: 使 用 StreamReader 类 来 读 取消 息 。 


using(StreamReader reader = new StreamReader(client)) 
{ 
string msg = null; 
while( (msg = reader.ReadLine()) != null) 
{ 
Console. WriteLine( $ "服务 器 : {msg}"); 
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步骤 9: 在 解决 方案 属性 中 将 两 个 应 用 项 目 都 设置 为 启动 项 目 。 
步骤 10: 同时 运行 两 个 项 目 , 在 服务 器 上 写 人 要 发 送 的 消息 , 按 Enter 键 确认 后 ,客户 
端 会 显示 接收 到 的 消息 ,如 图 8-20 所 示 。 


图 8-20 单 向 管道 通信 


序 列 化 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 简单 序列 化 方案 ; 

。 XML 序列 化 ; 

。 数据 协定 。 


9.1 简单 序列 化 方案 


实例 267 “二进制 序列 化 


【导语 】 

序列 化 (Serialization ,也 可 以 翻译 为 “ 串 行 化 ”) ,就 是 将 某 个 对 象 实例 的 状态 信息 存储 
到 可 传输 介质 中 ,例如 内 存 中 、 文 件 中 以 及 通过 网 络 发 送 的 数据 中 。 实 例 的 状态 信息 包括 对 
象 的 属性 和 字段 成 员 的 值 ( 不 包括 方法 和 事件 ) 。 

当 需 要 还 原 对 象 的 状态 信息 时 ,可 以 从 可 传输 介质 中 读 出 这 些 数 据 , 重 新 为 对 象 的 属性 
或 字段 成 员 赋值 ,此 过 程 称 为 反 序 列 化 (Deserialization ) 。 

所 谓 二 进 制 序列 化 ,就 是 将 对 象 实例 的 状态 信息 以 二 进 制 的 方式 存储 ,这 样 产 生 数据 的 
体积 小 ,但 不 便于 在 不 同 的 网 络 平台 之 间 传 输 。 要 让 自 定义 类 型 支持 二 进 制 序列 化 ,需要 在 
类 型 上 应 用 SerializableAttribute。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 Person 类 ,包含 两 个 公共 属性 , 稍 后 会 将 Person 类 的 实例 进行 序列 
化 和 反 序 列 化 。 


[Serializable] 
class Person 


{ 
public string Name { get; set; } 


public int Age { get; set; } 
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注意 : 让 类 型 支持 二 进 制 序列 化 ,必须 应 用 SerializableAttribute。 但 类 型 是 否 需要 定义 为 
公共 类 型 ,是 可 选 的 。 


步骤 3: 声明 一 个 字符 串 变 量 用 于 存放 序列 化 数据 的 文件 名 ,本 实例 会 将 Person 实例 
的 状态 信息 保存 到 文件 中 。 


string fileName = "demo. data"; 
步骤 4: 执行 序列 化 。 


using(FileStreanm fs = new FileStream(fileName, FileMode. OpenOrCreate)) 
E 
BinaryFormatter ft = new BinaryFormatter(); 
// 创建 Person 类 实例 
Person ps = new Person 
{ 
Name = "Jack", 
Age = 28 
}; 
ft. Serialize(fs, ps); 
} 


二 进 制 序列 化 用 到 的 是 BinaryFormatter 类 (需要 引入 System. Runtime. Serialization. 
Formatters. Binary 命名 空间 ) ,序列 化 时 只 要 调用 Serialize 方法 即 可 。 
步骤 $: 执行 反 序列 化 ,还 原 Person 对 象 的 状态 。 
using(FileStream fs = new FileStream(fileName, FileMode. Open)) 
{ 
BinaryFormatter ft = new BinaryFormatter(); 
// 从 已 保存 的 数据 中 读 出 Person 实例 
Person ps = (Person)ft.Deserialize(fs); 
// 输出 实例 的 属性 值 
Console. WriteLine( $ "Name: {ps.Name}\nAge: {ps. Age}"); 
} 
反 序列 化 调用 Deserialize 方法 ,该 方法 返回 的 类 型 为 object, 因 此 需要 强制 进行 类 型 转换 。 
步骤 6: 运行 应 用 程序 ,输出 反 序列 化 的 属性 值 如 下 。 


Name: Jack 
Age: 28 


实例 268 ”使 用 DataContractSerializer 类 进行 序列 化 


【导语 】 

DataContractSerializer 类 是 与 数据 协定 配套 使 用 的 类 ,但 它 也 可 以 对 未 应 用 协定 特性 
的 普通 类 型 进行 序列 化 和 反 序 列 化 。 默 认 情 况 下 ,DataContractSerializer 类 将 对 象 实例 序 
列 化 为 XML 数据 。 序 列 化 可 调用 WriteObject 方法 ,而 反 序列 化 可 调用 ReadObject 方法 。 
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【操作 流程 】 
步骤 1: 新建 一 个 控制 应 用 程序 项 目 。 
步骤 2: 引入 以 下 命名 空间 。 


using Systenm; 
using System. IO; 
using System. Runtime. Serialization; 


步骤 3: 声明 一 个 Student 类 , 稍 后 用 于 演示 序列 化 和 反 序列 化 。 
public class Student 
public int ID { get; set; } 


public string Name { get; set; } 
public string City { get; set; } 


DataContractSerializer 类 在 序列 化 时 不 要 求 应 用 SerializableAttribute, 因 此 Student 
类 上 面 不 需要 该 特性 。 
步骤 4: 执行 序列 化 。 


using(FileStream fs = new FileStream(fileName，FileMode. OpenOrCreate)) 


DataContractSerializer dcs = new DataContractSerializer(typeof(Student)); 
Student s = new Student 


{ 
ID = 1003, 
Name = "Zhang"， 
City = "BJ" 


}; 
dcs. WriteObject(fs, s); 
} 


步骤 5: 执行 反 序列 化 。 


using(FileStream fs = new FileStream(fileName, FileMode. Open)) 

{ 
DataContractSerializer dcs = new DataContractSerializer(typeof(Student)); 
Student s = dcs.ReadObject(fs) as Student; 


// 输出 属性 值 
Console. WriteLine( $ "ID: {s. ID}\nName: {s. Name}\nCity: {s.City}"); 


} 


步骤 6: 运行 应 用 程序 , 反 序 列 化 得 到 的 Student 实例 状态 如 
图 9-1 所 示 。 

DataContractSerializer 类 在 序列 化 Student 对 象 后 可 生成 如 下 的 
XML 内 容 。 


< Student xmlns = " http://schemas. datacontract. org/2004/07/Demo" 


xmlns:i= "http://www. w3. org/2001/XMLSchema - instance"> 图 9-1 反 序列 化 后 的 


Student 实例 
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<City> BJ</City> 
<ID>1003 </ID> 
< Name > Zhang </Name > 


</Student > 


实例 269 ”将 类 型 实例 序列 化 为 JSON 格式 

【导语 】 

DataContractJsonSerializer 类 (位 于 System. Runtime. Serialization. Json 命名 空间 中 ) 
支持 把 类 型 实例 序列 化 为 JSON 数据 格式 。JSON 格式 数据 的 体积 小 ,结构 简单 ,在 跨 平 台 
与 跨 网 络 传输 数据 时 更 为 方便 ,因此 在 Web 领域 被 广泛 使 用 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Pet 类 , 它 包 含 三 个 公共 属性 , 稍 后 将 演示 如 何 将 包含 Pet 对 象 的 数组 序 
列 化 为 JSON 数据 。 


public class Pet 


{ 


} 


public string Name { get; set; } 
public int Age { get; set; } 
public string Owner { get; set; } 


步骤 3: 执行 序列 化 。 


using (FileStream stream = File.Open(fileName, FileMode.OpenOrCreate)) 


{ 


: 


Pet[] pets = 

{ 
new Pet { Name = "Dog A", Age = 3, Owner = "Jack" }, 
new Pet { Name = "Cat E", Age = 2, Owner = "Bob" } 


}; 
DataContractJsonSerializer sz = new DataContractJsonSerializer(pets. GetType( )); 
sz. WriteObject( stream, pets); 


步骤 4: 执行 反 序列 化 。 


using(FileStreanm fs = File.OpenRead(fileName)) 


{ 


DataContractJsonSerializer sz = new DataContractJsonSerializer(typeof (Pet[ ])); 
Pet[] petsarr = (Pet[])sz.ReadObject(fs); 
// 输出 数组 中 的 元 素 
foreach(Pet p in petsarr) 
{ 
Console. WriteLine( $ "Name: {p.Name} \nAge: {p.AMge}\nOwner: {p.Owner}\n"); 
} 
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注意 : 由 于 序列 化 和 反 序 列 化 的 实际 类 型 是 数组 类 型 ,因此 在 实例 化 DataContractJsonSerializer 
类 时 应 该 将 type 参数 指定 为 typeof(Pet[]) 。 


步骤 5: 运行 应 用 程序 , 反 序 列 化 后 得 到 的 内 容 如 图 9-2 所 示 。 
本 实例 序列 化 Pet 数组 后 产生 如 下 JSON 文档 。 


$b 图 9-2 从 JSON 文件 中 


{ 反 序列 化 后 
"Age": 2, 的 数组 实例 
"Name": "Cat E 
Owner" : "Bob" 


由 于 原 对 象 是 数组 类 型 ,所 以 生成 的 JSON 对 象 会 被 一 对 中 括号 ([]) 括 起 来 。 
实例 270 在 序列 化 时 忽略 某 些 字段 


【导语 】 

在 序列 化 时 经 常会 忽略 类 型 中 一 些 字段 的 值 ,例如 私有 字段 。 忽 略 类 型 中 特定 字段 的 
值 , 需 要 在 字段 上 应 用 NonSerializedAttribute。 对 于 没有 应 用 NonSerializedAttribute 的 字 
役 ,默认 情况 下 会 被 序列 化 。 在 反 序 列 化 时 ,不 会 读 取 应 用 了 NonSerializedAttribute 的 字 
段 ,而 是 保持 其 默认 值 不 变 ( 假 设 字段 是 int 类 型 ,那么 它 的 默认 值 为 0) 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 本 实例 将 序列 化 的 数据 存放 在 内 存 中 ,因此 需要 创建 以 下 内 存 流 实 例 。 


MemoryStream mstream = new MemoryStream(); 

步骤 3: 创建 BinaryFormatter 实例 。 
BinaryFormatter ft = new BinaryFormatter(); 

步骤 4: 声明 一 个 Car 类 , 稍 后 用 于 序列 化 测试 。 


[Serializable] 

public class Car 

{ 
public string Color; 
public decimal Speed; 
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[NonSerialized] 
public decimal Weight; 
} 


Car 类 包含 三 个 公共 字段 ,其 中 Weight 字段 应 用 了 NonSerialized 特性 ,序列 化 时 该 字 
段 会 被 忽略 。 
步骤 5: 创建 一 个 Car 类 的 实例 并 为 各 个 字段 赋值 。 


Car cl = new Car 
{ 


Color = "White", 

Speed = 165.2M, 

Weight = 2325.6M 
}; 
步骤 6: 将 上 述 Car 实例 进行 二 进 制 序列 化 。 

ft. Serialize(mstream, c1); 

步骤 7: 内 存 流 的 当前 位 置 位 于 流 的 末尾 ,如 果 此 时 进行 反 序列 化 是 读 不 到 数据 的 ,所 
以 要 先 将 内 存 流 的 当前 位 置 移 到 流 的 开始 处 。 

mstream. Position = OL; 


步骤 8: 进行 反 序列 化 ,然后 在 控制 台 输 出 反 序 列 化 后 Car 实例 各 字段 的 值 。 


Car c2 = (Car)ft.Deserialize(mstream) 
// 输出 各 字段 的 值 


Console. WriteLine( $ "Color: {c2.Color}\nSpeed: {c2. Speed}\nWeight: {c2.Weight}"); 
步骤 9: 使 用 完 后 要 释放 内 存 流 实 例 。 

mstream. Dispose( ) ; 

步骤 10: 运行 应 用 程序 ,控制 台 输出 结果 如 下 。 


Color: White 
Speed: 165.2 
Weight: 0 


从 反 序 列 化 得 到 的 结果 可 以 看 出 ,Weight 字段 仅仅 保留 了 其 默认 值 0。 
9.2 XML 序列 化 


实例 271 XmlSerializer 与 XML 序列 化 


【导语 】 
在 System. Xml. Serialization 命名 空间 下 ,框架 提供 了 一 系列 专用 于 XML 序列 化 的 类 
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型 。 其 中 主要 的 类 是 XmlSerializer, 它 负责 执行 序列 化 和 反 序 列 化 任务 ,其 使 用 方法 与 
BinaryFormatter 类 相似 。 但 是 XmlSerializer 类 只 能 对 公共 类 型 (用 public 关键 字 修 饰 的 
类 型 ) 进 行 序 列 化 , 非 公共 类 型 会 发 生 异 常 ; 而 且 只 序列 化 公共 类 型 中 的 公共 成 员 , 非 公共 
成 员 会 被 忽略 。 

本 实例 将 演示 通过 XmlSerializer 类 对 类 型 实例 进行 简单 的 序列 化 与 反 序列 化 操作 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 TaskItem 类 ,包含 五 个 公共 属性 。 


public class TaskItem 

{ 
public int TaskID { get; set; } 
public DateTime StartTime { get; set; } 
public DateTime FinishTime { get; set; } 
public string TaskName { get; set; } 
public string TaskDesc { get; set; } 


步骤 3: 序列 化 TaskItem 实例 。 


using(FileStream fs = new FileStream(fileName, FileMode. OpenOrCreate)) 
{ 
TaskItem item = new TaskItem 
{ 
TaskID = 1001, 
StartTime = new DateTime(2018, 9, 6, 14, 30, 0), 
FinishTime = new DateTime(2018, 9, 7, 18, 0, 0), 
TaskName = "Track #91", 
TaskDesc = "Do Something" 


XmlSerializer xmlsz = new XmlSerializer(item.GetType()); 
xmlsz. Serialize(fs, item); 


} 
步骤 4: 执行 反 序列 化 , 读 出 TaskItem 实例 的 状态 。 


using(FileStream fs = new FileStream(fileName, FileMode. Open)) 
{ 

XmlSerializer xsz = new XmlSerializer(typeof(TaskItem)); 

TaskItem item = (TaskItem)xsz.Deserialize(fs); 

Console. WriteLine( $ "Task ID: {item. TaskID} \nTask Name: {item. TaskName} \nStart: {itenm. 
StartTime} \nFinish: {item. FinishTime}\nDesc: {item.TaskDesc}"); 


步骤 5: 运行 应 用 程序 ,控制 台 输 出 反 序 列 化 后 TaskItem 实例 中 各 属性 的 值 ,如 图 9-3 


334 二 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


图 9-3 反 序 列 化 得 到 的 TaskItem 实例 
TaskItem 实例 序列 化 后 生成 如 下 的 XML 文档 。 


<?xm] version= "1.0"?> 
< TaskItem xmlns:xsi= "http://www. w3.org/2001/XMLSchema - instance" 
xmlns:xsd = "http://www. w3. org/2001/XMLSchema"> 
<TaskID> 1001 </TaskID> 
< StartTime> 2018 - 09 - 06T14:30:00 </StartTime> 
<FinishTime > 2018 - 09 - 07T18:00:00 </FinishTime> 
< TaskName> Track #1</TaskName > 
< TaskDesc > Do Something </TaskDesc> 
</TaskItem> 


实例 272 自 定 义 封 装 集合 类 型 成 员 的 XML 元 素 名 称 

【导语 】 

如 果 类 型 的 某 个 成 员 ( 属 性 或 字段 ) 是 集合 类 型 (如 数组 .List< T > 等 ) ,该 成 员 在 XML 
序列 化 时 ,需要 生成 一 个 用 于 包装 集合 子 项 的 XML 元素。 默认 情 况 下 ,包装 子 项 的 XML 
元 素 名 称 与 成 员 名 称 相 同 ,例如 某 个 类 中 包含 以 下 属性 。 


public SubItem[ ] InnerItems { get; set; } 


那么 在 XML 序列 化 时 ,包装 列表 项 的 XML 元 素 可 以 按 以 下 形式 命名 为 Innerltems。 


< InnerItems > 
< SubItem > … </SubItem> 


</InnerItems > 


如 果 需 要 改变 默认 包装 元 素 的 名 称 , 可 以 在 InnerItems 属性 上 应 用 XmlArrayAttribute, 对 
应 如 下 代码 。 


[XmlArray("Inners")] 
public SubItem[ ] InnerItems { get; set; } 


修改 之 后 生成 的 XML 文档 如 下 。 


< Inners > 
< SubItem > … </SubItem> 
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</Inners> 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Test 类 ,包含 两 个 集合 类 型 的 属性 。 


public class Test 
{ 
public double[ ] Values { get; set; } 
[XmlArray("Strs")] 
public List < string> StringList { get; set; } 
} 


Values 属性 没有 应 用 XmlArrayAttribute, 因 此 它 序列 化 后 的 XML 元 素 名 称 与 属性 名 
称 相同 。 而 StringList 属性 应 用 了 XmlArrayAttribute, 序 列 化 后 生成 的 XML 元 素 名 为 
Strs。 


步骤 3: 将 Test 类 的 实例 进行 XML 序列 化 ,并 将 序列 化 后 的 数据 保存 到 内 存 流 中 。 


using(MemoryStream ms = new MemoryStream()) 


{ 


Test t = new Test 


{ 
Values = new double[ ] 


0.33d, 1.10005d, 12.456d 
}, 
StringList = new List< string> 
上 
mont 1" "Test 2 "Tout 3 
} 
}; 
XmlSerializer sz = new XmlSerializer(typeof(Test)); 
sz. Serialize(ms, 七 ) ; 
// 输出 XML 文档 
ms. Position = 0L; 
using(StreamReader reader = new StreamReader(ms)) 
{ 


Console. WriteLine( reader. ReadToEnd( ) ); 
} 


将 Test 实例 进行 XML 序列 化 后 ,使 用 StreamReader 类 从 内 存 流 中 读 出 所 有 内 容 , 并 
将 内 容 输出 到 控制 台 。 
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步骤 4: 运行 应 用 程序 ,序列 化 产生 的 XML 文档 如 下 。 


<?xml version = "1.0"?> 
< Test xmlns:xsi = "http://www.w3.org/2001/XMLSchema - instance" 
xmlns:xsd = "http://www. w3. org/2001/XMLSchema"> 
<Values> 
<double>0.33</double> 
<double>1.10005 </double> 
< double> 12.456 </double> 
</Values > 
< Strs> 
< string> Test 1 </string> 
< string> Test 2 </string> 
< string> Test 3 </string> 
</Strs> 
</Test> 


在 上 述 XML 文档 中 ,封装 StringList 属性 的 XML 元 素 名 称 已 变 为 Strs。 

实例 273” 自 定义 XML 元 素 的 名 称 

【导语 】 

XML 序列 化 会 默认 产生 与 类 型 成 员 ( 公 共 属 性 或 公共 字段 ) 名 称 相同 的 元 素 , 但 在 一 
些 应 用 场合 中 需要 改变 生成 的 XML 元 素 的 名 称 。 

有 两 个 Attribute 常用 于 自 定 义 XML 元 素 的 名 称 : XmlRootAttribute 可 应 用 于 类 型 
(例如 类 、 枚 举 、 结 构 等 ), 以 自 定义 序列 化 所 产生 的 XML 文档 的 根 元 素 名 称 。 
XmlElementAttribute 可 应 用 于 类 型 成 员 , 以 自 定义 生成 的 XML 元 素 的 名 称 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Production 类 ,用 于 稍 后 做 序列 化 测试 。 在 定义 该 类 时 应 用 了 XmlRoot 
特性 ,指定 根 元 素 的 名 称 为 prod_info, 并 在 各 个 公共 属性 上 应 用 XmlElement 特性 ,以 指定 
每 个 子 元 素 的 名 称 。 

[XmlRoot("prod_info")] 


public class Production 


{ 


[XmlElement("prod_id")] 

public long ProductID { get; set; } 
[XmlElement("prod time")] 

public DateTime ProductTime { get; set; } 
[XmlElement("prod_size")] 

public float ProductSize { get; set; } 
[XmlElement ("prod_ remarks")] 

public string ProductRemarks { get; set; } 
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步骤 3: 以 下 代码 将 Production 类 的 实例 序列 化 并 保存 到 一 个 XML 文件 中 。 


using(FileStream fs = new FileStream("data. xml", FileMode.Create)) 
{ 
// 实例 化 Production 类 
Production prd = new Production 
{ 
ProductID = 7078201, 
ProductTime = new DateTime(2018, 1, 3), 
ProductSize = 37.33f, 
ProductRemarks = "new style" 
}; 
// 输出 序列 化 前 的 状态 
StringBuilder strbd = new StringBuilder(); 
strbd. AppendLine( $ "产品 ID: {prd. ProductID}"); 
strbd. AppendLine( $ "生产 日 期 :{prd. ProductTime:d}"); 
strbd. AppendLine( $ "尺寸 :{prd. ProductSize}"); 
strbd. RppendLine( $ "备注 :{prd. ProductRemarks}"); 
Console. Write(strbd + "\n\n"); 
// 进行 序列 化 
XmlSerializer serializer = new XmlSerializer(prd.GetType()); 
serializer. Serialize(fs, prd); 


} 
步骤 4: 读 取 并 输出 序列 化 后 生成 的 XML 文件 。 


using(FileStream fs = new FileStream("data.xml", FileMode. Open)) 
{ 
using(StreamReader reader = new StreamReader(fs)) 
{ 
string xml = reader.ReadToEnd(); 
Console. WriteLine( "序列 化 后 生成 的 XML 文档 :"); 
Console. Write(xml); 


} 
步骤 5: 运行 应 用 程序 ,序列 化 后 生成 的 XML 文档 如 下 。 


<?xml version = "1.0"?> 
< prod_info xmlns:xsi= "http://www.w3.org/2001/XMLSchema — instance" 
xmlns:xsd = "http://www.w3.org/2001/XMLSchema"> 
<prod_id> 7078201 </prod id> 
<prod time> 2018- 01— 03T00:00:00 </prod time> 
<prod_size> 37.33 </prod_size> 
< prod_remarks > new style </prod_remarks > 
</prod_info> 


从 上 述 XML 文档 可 以 发 现 ,文档 的 根 元 素 的 名 称 已 变 为 prod_info,ProductID 属性 对 
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应 的 XML 元 素 名 称 变 为 prod_id, 其 他 属性 的 名 称 也 以 此 类 推 。 


实例 274 ”将 类 型 成 员 序列 化 为 XML 特性 


【导语 】 

默认 的 序列 化 方案 会 把 类 型 成 员 ( 主 要 是 公共 属性 和 公共 字段 ) 序 列 化 为 XML 元素， 
但 是 如 果 在 类 型 成 员 上 应 用 XmlAttributeAttribute( 第 二 个 “ Attribute” 是 特性 类 的 约定 名 
称 ,在 代码 中 使 用 时 可 以 直接 忽略 第 二 个 “Attribute”) ,就 可 以 通知 序列 化 程序 将 类 型 的 成 
员 序 列 化 为 XML 特性 。 

例如 类 型 A 有 个 公共 属性 工 , 默 认 的 序列 化 结果 如 下 。 

<A> 


<T> … </T> 
</A> 


应 用 了 XmlAttribute 特性 后 的 序列 化 结果 如 下 。 

< 有 RT="…n" /> 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Test 类 , 它 包含 三 个 公共 字段 , 稍 后 将 用 于 序列 化 。 


[XmlRoot("demo_test")] 
public class Test 
{ 


[XmlAttribute("val_a")] 
public int ValueA; 
[XmlAttribute("val_b")] 
public bool ValueB; 
[XmlaAttribute("val_c")] 
public string ValueC; 

} 


应 用 XmlAttribute 特性 时 还 可 以 自 定义 其 名 称 ,如 果 不 指定 名 称 , 则 默认 与 字段 的 名 
称 相同 。 例 如 , 若 ValueA 字段 上 不 指定 自 定义 的 XML 特性 名 ,那么 序列 化 后 生成 的 XML 
特性 名 称 为 ValueA; 本 例 中 已 指定 名 称 为 val_a, 那 么 序列 化 后 生成 的 XML 特性 名 称 就 会 
是 val_a。 

步骤 3: 实例 化 内 存 流 , 序 列 化 产生 的 XML 文档 将 存放 在 内 存 流 中 。 

MemoryStream ms = new MemoryStream( ) ; 


步骤 4: 实例 化 Test 类 ,并 为 各 字段 赋值 。 


Test t = new Test 


{ 
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ValueA = 60000, 
true, 
"Start up" 


步骤 5: 执行 序列 化 操作 。 


XmlSerializer sz = new XmlSerializer(t.GetType()); 
sz. Serialize(ms, t+); 


步骤 6: 从 内 存 流 中 读 出 序列 化 后 生成 的 XML 文档 。 


ms. Position = OL; 
String xmlDoc = null; 
using(StreamReader reader = new StreamReader(ms)) 


{ 
xmlDoc = reader. ReadToEnd(); 
} 
往 内 存 流 中 写 入 数据 后 流 的 当前 位 置 在 末尾 ,因此 要 把 Position 属性 设置 为 0, 使 流 的 
当前 位 置 回 到 流 的 首位 ,否则 读 不 到 内 容 。 
Test 实例 序列 化 之 后 生成 如 下 的 XML 文档 。 


<?xml version= "1.0"?> 


<demo test xmlns:xsi="..." xmlns:xsd="..." 
val_ a= "60000" 
val_b= "true" 
val c= "Start up" 
实例 275” 自 定义 XML 命名 空间 
【导语 】 


XmlRootAttribute、XmlElementAttribute 和 XmlAttributeAttribute 特性 类 都 公开 了 
一 个 Namespace 属性 , 它 的 作用 是 设置 XML 序列 化 时 各 个 XML 文档 对 象 的 命名 空间 。 
XML 命名 空间 一 般 使 用 URL 形式 (如 http: //xxx. net) ,这 是 因为 URL 的 唯一 性 不 易 造 
成 命名 空间 的 重复 ,当然 也 可 以 使 用 其 他 命名 形式 (例如 , 叫 my. test) 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Test 类 ,用 于 序列 化 测试 ,该 类 包含 两 个 公共 属性 。 

[XmlRoot(Namespace = "test.org")] 

public class Test 


{ 
[XmlElement(Namespace = "test.org/prop")] 
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public int Valuel { get; set; } 
[XmlElement(Namespace = "test.org/prop")] 
public string Value2 { get; set; } 

} 

在 Test 类 上 ,通过 XmlRoot 特性 类 的 Namespace 属性 指定 一 个 自 定义 的 命名 空间 
test. org。 在 公共 属性 上 ,通过 XmlElement 特性 类 的 Namespace 属性 指定 命名 空间 为 
test. org/ prop。 

步骤 3: 在 Main 方法 中 ,将 Test 类 的 实例 序列 化 并 存放 到 内 存 流 上 ,然后 从 内 存 流 中 
读 出 生成 的 XML 文档 。 


using(MemoryStream ms = new MemoryStream()) 


{ 


Test vt = new Test 


{ 
Valuel = 
Value2 = 
}; 
XmlSerializer szr = new XmlSerializer(vt.GetType()); 


szr. Serialize(ms, vt); 


ms. Position = OL; 
using(StreamReader rd = new StreamReader(ms)) 


{ 
string xml = rd.ReadToEnd(); 
Console. Write( $ "序列 化 后 生成 的 xML 文档 :\n{xm1}"); 


} 
步骤 4: 运行 应 用 程序 ,输出 的 XML 文档 如 下 。 


<?xml version= "1.0"?> 


<Test xmlns:xsi="..." xmlns:xsd="..." xmlns = "test. org"> 


<Valuel xmlns = "test. org/prop"> 96 </Valuel > 
< Value2 xmlns = "test. org/prop"> one </Value2 > 
</Test> 


在 Test 根 元 素 上 ,xmlns 二 "test. org" 为 自 定义 的 命名 空间 ; 同 理 ,在 Valuel 和 Value2 
元 素 上 ,xmlns 二 "test. org/prop" 为 自 定义 的 命名 空间 。 

实例 276” 自 定义 数组 类 型 成 员 的 XML 元 素 

【导语 】 

在 进行 XML 序列 化 时 ,数组 (或 者 List 及 其 他 集合 类 型 ) 类 型 结构 比较 特殊 ,因为 它 包 


含 一 系列 子 元 素 ,在 做 XML 封装 时 , 既 需 要 外 层 的 封装 元 素 , 也 需要 封装 内 部 子 元 素 。 默 
认 的 序列 化 方案 使 用 与 类 型 成 员 相 同名 称 的 XML 元 素来 包装 数组 实例 ,而 数组 实例 中 每 
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个 元 素 则 用 其 类 型 名 称 作 为 XML 元 素 的 名 称 。 若 数组 中 的 元 素 类 型 是 字符 串 ,那么 序列 
化 后 生成 的 XML 元 素 如 下 。 


< 成 员 名 称 > 
< string>…</string> 
< string>…</string> 


</ 成 员 名 称 > 


但 有 时 并 不 使 用 默认 的 序列 化 行为 ,如 果 要 对 数组 类 型 的 封装 做 自 定 义 处 理 , 需 要 用 到 
以 下 两 个 特性 类 。 

XmlArrayAttribute: 自 定义 包装 数组 对 象 的 元 素 ,用 法 与 XmlElementAttribute 相似 ， 
用 于 替换 默认 的 类 型 成 员 名 称 。 

XmlArrayItemAttribute: 用 于 替换 数组 中 子 元 素 的 默认 封装 名 称 。 

本 实例 将 对 比 演示 两 个 结构 相同 的 类 来 进行 ,其 中 一 个 类 采用 默认 序列 化 方案 ,而 另 一 
个 类 则 进行 了 自 定义 处 理 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Testl 类 ,该 类 不 使 用 任何 特性 修饰 。 


public class Test1l 
{ 
public int ItemCount; 
public string[ ] Items; 
} 


步骤 3: 声明 Test2 类 ,对 Items 字段 应 用 相关 的 特性 ,指定 成 员 封装 元 素 名 为 item_ 
list, 数 组 中 元 素 的 封装 元 素 名 为 sub_item。 


public class Test2 

{ 
public int ItemCount; 
[Xmlarray("item_list")] 
[XmlArrayItem("sub_item")] 
public string[ ] Items; 

} 


步骤 4: 两 个 类 的 序列 化 过 程 相似 ,为 了 避免 编写 过 多 的 重复 代码 ,可 以 统一 编写 一 个 
方法 来 执行 序列 化 ,通过 泛 型 参数 来 传递 Testl 或 Test2 实例 。 


static void Serialize<T>(T obj) 
{ 
using (MemoryStream ms = new MemoryStream()) 
{ 
XmlSerializer sz = new XmlSerializer(typeof(T)); 
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sz. Serialize(ms, obj); 


ms. Position = 0L; 
using (StreamReader rd = new StreamReader(ms)) 
{ 

string xml = rd.ReadToEnd(); 

Console. Write(xml + "\n\n"); 


} 
步骤 5: 在 Main 方法 中 ,对 Testl .Test2 实例 分 别 进行 序列 化 。 


Testl tl = new Test1(); 

tl1. Items = new string[] { "item 1"，"item 2", "item 3" }; 
t1. ItemCount = t1.Items.Length; 

Console. WriteLine(" 默 认 序列 化 方案 :"); 

Serialize(t1); 

Test2 t2 = new Test2(); 

t2. Items = new string[] { "item 1", "item 2", "item 3" }; 
t2. ItemCount = t2.Items.Length; 

Console. WriteLine(" 自 定义 序列 化 方案 :"); 

Serialize(t2); 


步骤 6: 运行 应 用 程序 ,观察 其 输出 的 结果 。 
对 于 默认 序列 化 方案 ,将 生成 以 下 XML 文档 。 


<?xml version = "1.0"?> 
<Testl …> 
< ItemCount > 3 </ItemCount > 
< Items > 
< string > item 1 </string> 
< string > item 2 </string> 
< string > item 3 </string> 
</Items > 
</Testl > 


对 于 自 定义 方案 ,将 生成 以 下 XML 文档 。 


<?xml version = "1.0"?> 
< Test2 …> 
< ItemCount > 3 </ItemCount > 
<item list> 
< sub_item> item 1 </sub_item> 
< sub_item> item 2</sub item> 
< sub_item> item 3 </sub_item> 
</item_1ist> 
</Test2 > 
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9.3 数据 协定 


实例 277 数据 协定 的 简单 定义 


【导语 】 

数据 协定 是 一 种 约定 , 它 要 求 参与 约定 的 类 型 以 及 其 成 员 结构 必须 匹配 ,但 类 型 以 及 类 
型 的 成 员 名 称 不 一 定 相同 。 假 设 ,A 类 的 协定 名 称 为 user_a,P1 属性 的 协定 名 称 为 pop_1， 
P2 属性 的 协定 名 称 为 pop_2。 用 A 类 的 实例 序列 化 之 后 生成 的 数据 去 填充 B 类 的 实例 , 虽 
然 也 类 的 两 个 属性 分 别 为 V1 和 V2, 但 是 它 所 使 用 的 数据 协定 名 称 与 A 类 相同 ,此 时 是 可 
以 顺利 进行 反 序列 化 的 ,因为 它们 均 符合 数据 协定 的 要 求 。 

数据 协定 最 大 的 作用 是 在 网 络 传 输 中 保证 数据 模型 的 统一 ,即使 数据 的 发 送 方 与 接收 
方 声明 了 不 同 的 类 型 ,只 要 双方 遵守 数据 协定 ,就 可 以 完成 序列 化 与 反 序 列 化 。 

本 实例 仅仅 声明 一 个 简单 的 数据 协定 ,并 使 用 DataContractSerializer 类 进行 序列 化 ， 
然后 将 序列 化 的 结果 输出 到 控制 台 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Album 类 ,并 应 用 数据 协定 相关 的 类 。 


[DataContract] 
public class Album 
{ 
[DataMember] 
public string Title { get; set; } 
[DataMember] 
public string Artist { get; set; } 
[DataMember] 
public int Year { get; set; } 
[DataMember] 
public string Cover { get; set; } 
} 


在 类 型 定义 上 应 当 使 用 DataContractAttribute, 而 DataMemberAttribute 类 只 应 用 于 
类 型 成 员 上 (一 般 是 字段 和 属性 )。 
步骤 3: 实例 化 内 存 流 , 用 于 存放 序列 化 后 生成 的 数据 。 


using(MemoryStream ms = new MemoryStream()) 
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步骤 4: 创建 Album 实例 。 


Album ab = new Album 

{ 
Title = "Lee Songs"， 
Year = 2007, 
Artist = "Lee Tan"， 
Cover = "05. jpg" 

}; 


步骤 5: 执行 序列 化 。 


DataContractSerializer szr = new DataContractSerializer(ab. GetType( )); 
szr. WriteObject(ms, ab); 


步骤 6: 读 取 并 显示 序列 化 的 结果 ,此 结果 是 一 个 XML 文档 。 


ms,Position = OL; 
using(StreamReader reader = new StreamReader(ms) ) 
{ 
string data = reader.ReadToEnd(); 
Console. WriteLine( $ "序列 化 后 的 内 容 如 下 :\n{data}"); 
} 


步骤 7: 运行 应 用 程序 ,数据 协定 序列 化 后 生成 的 XML 文档 如 下 。 


<Rlbum xmlns ="…"”xmlns:i="…"><Rrtist> Lee 
Tan </Rrtist > < Cover > 05. jpg </Cover > < Title > Lee Songs </Title > < Year > 2007 </Year > 
</Album> 


DataContractSerializer 类 采用 XML 格式 进行 序列 化 ,产生 的 结果 与 XmlSerializer 类 
相似 ,但 DataContractSerializer 类 会 删除 XML 文档 中 的 空白 字符 ,尽量 地 压缩 文档 体积 ， 
便于 网 络 传输 。 


实例 278 ” 自 定义 协定 的 名 称 


【导语 】 

与 XML 相似 , 数据 协定 也 可 以 进行 自 定义 。DataContractAttribute 类 与 
DataMemberAttribute 类 都 公开 了 Name 属性 ,该 属性 的 作用 是 改变 协定 的 默认 名 称 (默认 
名 称 与 类 型 名 称 相同 )。 

本 实例 将 演示 自 定义 数据 协定 名 称 的 方法 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 Disk 类 , 它 包 含 两 个 公共 属性 。 


[DataContract(Name = "disk info")] 
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public class Disk 

[DataMember(Name = "total space")] 

public long Space { get; set; } 

[DataMember(Name = "driver type")] 

public byte Type { get; set; } 

步骤 3: 将 Disk 实例 进行 序列 化 ,并 将 结果 写 人 文件 。 


using (FileStream fs = File.Open("data. xml", FileMode. Create) ) 


Disk d = new Disk 
{ 
Space = 560008210310, 
TYpe = 0x0C 
}; 
DataContractSerializer sz = new DataContractSerializer(d. GetType( )); 
sz, WriteObject(fs, d); 
} 


步骤 4: 从 保存 的 文件 中 读 出 XML 文档 ,输出 到 控制 台 。 


using(StreamReader reader = new StreamReader("data. xml") ) 
{ 

Console. Write(" 序 列 化 后 输出 的 结果 :\n"); 

Console. Write(reader. ReadToEnd( ) ); 
? 


步骤 $: 运行 应 用 程序 ,Disk 类 实例 在 序列 化 后 输出 的 XML 文档 如 下 。 


< disk_info …> 
<driver type> 12 </driver type> 
<total_space> 560008210310 </total_space> 
</disk_info> 
从 输出 结果 看 到 ,文档 的 根 元 素 已 命名 为 disk_info, 两 个 成 员 依 次 命名 为 driver_type 
和 total_space, 而 不 是 使 用 类 型 默认 的 名 称 。 


实例 279 不 同 的 类 型 使 用 相同 的 数据 协定 


【导语 】 

本 实例 将 展示 数据 协定 的 用 途 一 一 对 于 结构 相同 而 命名 不 同 的 类 型 ,只 要 使 用 一 致 的 
数据 协定 ,就 能 完成 序列 化 与 反 序列 化 ,这 样 的 设计 模式 是 为 了 实现 跨 网 络 、 跨 应 用 、 跨 平台 
传输 数据 。 

本 实例 中 将 用 到 两 个 类 : StudentV1 与 StudentV2, 虽 然 类 型 名 称 和 成 员 名 称 不 同 ,但 
它们 结构 相同 ,成 员 的 数据 类 型 也 相同 ,只 要 它们 使 用 一 致 的 数据 协定 ,就 可 以 通过 序列 化 
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来 传递 。 在 本 例 中 ,将 StudentV1 类 的 实例 进行 序列 化 ,在 反 序列 化 时 则 使 用 StudentV2 
类 型 的 变量 进行 接收 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 StudentV1 类 和 StudentV2 类 。 


[DataContract(Namespace = "demo", Name = "stu data")] 
public class StudentV1 
{ 
[DataMember(Name = "stu id")] 
public long ID { get; set; } 
[DataMember(Name = "stu name")] 
public string Name { get; set; } 
[DataMember(Name = "stu email")] 
public string Email { get; set; } 
» 


[DataContract(Namespace = "demo", Name = "stu data")] 
public class StudentV2 
{ 
[DataMember(Name = "stu id")] 
public long StudentID { get; set; } 
[DataMember(Name = "stu name")] 
public string StudentName { get; set; } 
[DataMember(Name = "stu email")] 
public string StudentEmail { get; set; } 


注意 : 对 于 DataContractAttribute 而 言 , 如 果 要 严格 规范 数据 协定 的 名 称 ,应 当 同 时 设置 
Namespace 属性 与 Name 属性 ,以 提高 数据 协定 的 唯一 性 与 准确 性 。 


步骤 3: 将 StudentV1 实例 序列 化 ,输出 结果 写 入 XML 文件 。 


using(FileStream fs = new FileStream("test.xml", FileMode.Create)) 
{ 
StudentV1 stl = new StudentV1 
{ 
ID = 201811428023, 
Name = "Zhao"， 
Email = "t003@21cn. com" 
}; 
DataContractSerializer szr = new DataContractSerializer(stl.GetType()); 
szr. WriteObject(fs, st1); 
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步骤 4: 从 该 XML 文件 中 读 入 数据 ,进行 反 序 列 化 ,但 接收 状态 信息 的 类 型 是 
StudentV2。 


using(FileStreanm fs = new FileStream("test.xml", FileMode. Open)) 
{ 


DataContractSerializer sz = new DataContractSerializer(typeof(StudentV2)); 
StudentV2 st2 = (StudentV2)sz.ReadObject(fs); 


string msg = "序列 化 后 的 状态 信息 :\n" + 
$ "学 员 姓 名 :{st2. StudentName}\n" + 
$ "学 员 编 号 :{st2. StudentID}\n" + 
$ "学 员 电 邮 :{st2. StudentEmail}"; 
Console. Write(msg); 


} 图 9-4 反 序列 化 后 的 
步骤 5, 运行 应 用 程序 ,控制 台 输出 结果 如 图 9-4 所 示 。 i 


实例 280 ”将 数据 协定 序列 化 为 JSON 格式 


【导语 】 

DataContractSerializer 类 默认 将 数据 协定 以 XML 格式 序列 化 , 若 需要 序列 化 为 JSON 
格式 ,就 得 使 用 DataContractJsonSerializer 类 (位 于 System. Runtime. Serialization. Json 命 
名 空间 ) ,该 类 的 使 用 方法 与 DataContractSerializer 类 是 一 样 的 ,只 是 输出 的 数据 格式 不 同 
而 已 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Sample 类 , 它 包 含 三 个 公共 字段 。 


[DataContract] 

public class Sample 

{ 
[DataMember(Name = "val_1")] 
public double TestVall; 
[DataMember(Name = "val_2")] 
public DateTime TestVal2; 
[DataMember(Name = "val 3")] 
public uint TestVal3; 


注意 ; 由 于 JSON 对 象 是 使 用 一 对 大 括号 括 起 来 的 ,没有 根 元 素 , 因 此 在 应 用 
DataContractAttribute 时 可 以 忽略 Namespace 和 Name 属性 。 


步骤 3: 执行 序列 化 ,并 将 结果 输出 到 文件 中 。 
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using(FileStream fs = new FileStream("data.json", FileMode.Create)) 
{ 
Sample sl = new Sample 
{ 
TestVall 333.6515d, 
TestVal2 = DateTime. Now, 
TestVal3 = 797001 
}; 
DataContractJsonSerializer jsonsz = new DataContractJsonSerializer(typeof(Sample)); 
jsonsz. WriteObject(fs, sl1); 


} 

步骤 4: 执行 反 序 列 化 ,从 文件 中 读 出 数据 ,填充 一 个 Sample 类 的 实例 ,然后 在 控制 台 
输出 各 个 公共 字段 的 值 。 

using(FileStream fs = new FileStream("data. json", FileMode. Open) ) 
DataContractJsonSerializer jssz = new DataContractJsonSerializer(typeof(Sample)); 
Sample obj = jssz.ReadObject(fs) as Sample; 


Console. Write ( $ " {nameof (Sample. TestVall)} = {obj. TestVall} \ n {nameof (Sample. 
TestVal2)} = {obj.TestVal2}\n{nameof(Sample.TestVal3)} = {obj.TestVal3}"); 


步骤 5: 运行 应 用 程序 ,Sample 类 实例 被 序列 化 后 得 到 如 下 的 JSON 数据 。 


"wal 1"? 393.6515; 
"val_2": "\/Date(1534473729367 + 0800)\/", 
"val_3": 797001 


实例 281 序列 化 数据 协定 时 忽略 某 个 成 员 


【导语 】 

有 时 候 并 不 需要 一 个 类 型 中 所 有 的 成 员 ( 属 性 与 字段 ) 都 参与 序列 化 ,要 阻止 某 个 成 员 
被 序列 化 ,需要 在 成 员 定义 上 应 用 IgnoreDataMemberAttribute。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Record 类 作为 数据 协定 , 稍 后 用 于 序列 化 。 


[DataContract(Namespace = "test— rd- data"，Name = "rd body")] 
public class Record 
{ 

[DataMember(Name = "rd_ord")] 

public int RecordOrder { get; set; } 

[DataMember(Name = "rd title")] 
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public string RecordTitle { get; set; } 
[DataMember(Name = "rd_size")] 
public long SizeInBytes { get; set; } 
[IgnoreDataMember] 
public bool Tracked { get; set; } 

} 


在 序列 化 时 ,Tracked 属性 会 被 忽略 , 即 在 序列 化 后 生成 的 数据 中 不 会 包含 与 该 属性 有 
关 的 信息 。 


步骤 3: 执行 序列 化 。 


using(FileStream fs = new FileStream("rd. xml", FileMode. Create)) 
{ 
Record rd = new Record 
{ 
RecordOrder = 1, 
RecordTitle = "Numbers", 
SizeInBytes = 12105, 
Tracked = true 
}; 
DataContractSerializer szr = new DataContractSerializer(typeof(Record)); 
szr. WriteObject(fs, rd); 
‘ 


步骤 4: 执行 反 序列 化 ,并 输出 反 序 列 化 后 得 到 的 Record 实例 信息 。 


using(FileStream fs = new FileStream("rd. xml", FileMode. Open)) 


{ 
DataContractSerializer sz = new DataContractSerializer(typeof (Record)); 
Record rd = sz.ReadObject(fs) as Record; 
// 输出 各 属性 的 值 
string msg = null; 
msg += $"{nameof(rd.RecordOrder)} = {rd.RecordOrder}\n"; 
msg += $"{nameof(rd.RecordTitle)} = {rd.RecordTitle}\n"; 
msg += $"{nameof(rd.SizeInBytes)} = {rd.SizeInBytes}\n"; 
msg += $"{nameof(rd.Tracked)} = {rd.Tracked}"; 
Console. WriteLine(" 反 序列 化 得 到 的 Record 实例 :"); 
Console. Write(msg); 

} 


步骤 5: 运行 应 用 程序 ,控制 台 输 出 的 内 容 如 图 9-5 所 示 。 


图 9-5 反 序 列 化 得 到 的 Record 实例 
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Record 实例 序列 化 后 生成 的 XML 文档 如 下 。 


<rd body xmlns = "test— rd— data" xmlns:i=".…"> 
<rd_ord>1</rd_ord> 
<rd size>12105 </rd_size> 
<rd title> Numbers </rd title> 


</rd_body> 

从 生成 的 XML 文档 中 可 以 看 出 ,只 有 三 个 属性 被 序列 化 ,Tracked 属性 没有 参与 序 
列 化 。 

实例 282 ”改变 数据 协定 成 员 的 序列 化 顺序 

【导语 】 


一 般 会 按照 以 下 规则 来 序列 化 数据 协定 的 成 员 。 

(1) 如 果 数 据 协 定 类 型 具有 继承 关系 ,那么 基 类 成 员 会 优先 进行 序列 化 ,然后 再 处 理 派 
生 类 的 成 员 。 

(2) 对 于 没有 设置 DataMemberAttribute. Order 属性 的 成 员 ,将 按照 字母 顺序 排序 。 

(3) 如 果 设 置 了 DataMemberAttribute. Order 属性 ,将 按照 该 顺序 进行 处 理 。 

(4) 如 果 设 置 了 DataMemberAttribute. Order 属性 ,但 是 有 多 个 成 员 的 Order 相同 , 那 
么 就 先 按 Order 属性 的 值 进行 排序 ,对 于 Order 属性 相同 的 成 员 则 按 字母 顺序 排序 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Test 类 , 它 包含 四 个 公共 属性 。 


[DataContract] 
public class Test 
{ 
[DataMember] 
public string PropD { get; set; } 
[DataMember] 
public long PropC { get; set; } 
[DataMember] 
public int PropB { get; set; } 
[DataMember] 
public short PropA { get; set; } 
} 


步骤 3: 对 Test 实例 进行 序列 化 。 


using(FileStream fs = new FileStream("data. xml", FileMode. Create)) 
{ 
Test t = new Test 
{ 
PropR = 3, 
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PropB = 15, 
PropC = 100000L, 
PropD = "abcde" 


}; 
DataContractSerializer sz = new DataContractSerializer(typeof(Test)); 
sz. WriteObject(fs, t); 

} 


步骤 4: 输出 序列 化 后 生成 的 XML 文档 。 


using(FileStream fs = new FileStream("data.xml", FileMode. Open)) 
{ 

XDocument doc = XDocument. Load(fs); 

Console. Write("Test 实例 序列 化 后 生成 的 XML 文档 :\n" + doc); 
} 


XDocument 类 位 于 System. Xml. Lind 命名 空间 中 ,直接 调用 它 的 Load 静态 方法 就 可 
以 加 载 XML 文档 。XDocument 实例 在 转换 为 文本 时 会 自动 对 XML 文档 进行 缩 进 对 齐 。 
步骤 5: 此 时 运行 应 用 程序 ,控制 台 输出 的 XML 文档 如 下 。 


<Test …> 
<PropA> 3</PropA> 
<PropB> 15 </PropB> 
< PropC > 100000 </PropC> 
< PropD > abcde </PropD> 
</Test> 


这 是 成 员 序 列 化 的 默认 顺序 一 一 按照 字母 顺序 排列 。 
步骤 6: 回 到 Test 类 的 定义 代码 ,为 各 个 属性 设置 DataMemberAttribute. Order 属性 。 


[DataContract] 

public class Test 

{ 
[DataMember(Order = 2)] 
public string PropD { get; set; } 
[DataMember(Order = 0)] 
public long PropC { get; set; } 
[DataMember(Order = 1)] 
public int PropB { get; set; } 
[DataMember(Order = 3)] 
public short PropA { get; set; } 

} 


步骤 7: 再 次 运行 应 用 程序 ,这 次 生成 的 XML 文档 如 下 。 


< Test…> 
< PropC > 100000 </PropC> 
<PropB> 15 </PropB> 
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< PropD> abcde </PropD> 
<PropA>3</PropA> 
</Test> 


子 元 素 顺 序 变 为 PropC->PropB->PropD->PropA。 
实例 283 ”保留 实例 引用 
【导语 】 


因为 Order 属性 的 设置 ,数据 协定 成 员 的 序列 化 顺序 也 随 之 改变 ,此 时 Test 元 素 下 的 


开启 保留 实例 引用 选项 后 ,在 序列 化 的 时 候 会 为 每 个 实例 分 配 一 个 id, 以 保证 每 个 实例 
在 序列 化 时 只 生成 一 次 。 如 果 某 个 实例 被 多 个 成 员 引 用 ,那么 只 有 该 实例 第 一 次 出 现时 才 
会 填充 数据 ,随后 对 该 实例 的 引用 都 使 用 为 实例 所 分 配 的 id, 这 样 就 可 以 缩减 文档 的 长 度 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 声明 两 个 类 ,它们 都 是 数据 协定 ,并 且 OrderInfo 类 的 DetailsData 属性 引用 


OrderDetails 的 实例 。 


[DataContract] 
public class OrderDetails 
{ 
[DataMember] 
public string ContactName { get; set; } 
[DataMember] 
public decimal Price { get; set; } 
[DataMember] 
public int Quantity { get; set; } 
[DataMember] 
public float Weight { get; set; } 
} 


[DataContract] 
public class OrderInfo 
{ 
[DataMember] 
public int OrderNo { get; set; } 
[DataMember] 
public DateTime BuildTime { get; set; } 
[DataMember] 
public OrderDetails DetailsData { get; set; } 
} 


步骤 3: 执行 序列 化 。 


using (FileStream fs = File.Open("data. xml", FileMode. Create)) 
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OrderDetails dtl = new OrderDetails 
{ 

ContactName = "Lee", 

Price = 3.15M, 

Quantity = 12, 

Weight = 17.5f 
}; 


OrderInfo[ ] ords = 
{ 
new OrderInfo 
{ 
OrderNo = 1, 
BuildTime = new DateTime(2018, 3, 27), 
DetailsData = dtl 
}, 
new OrderInfo 
{ 
OrderNo = 2, 
BuildTime = new DateTime(2018, 9, 2), 
DetailsData = dtl 


}; 


DataContractSerializer sz = new DataContractSerializer(ords. GetType()); 
sz. WriteObject(fs, ords); 
} 


代码 首先 创建 OrderDetails 实例 ,然后 再 创建 OrderInfo 数组 ,数组 中 的 两 个 元 素 都 引 
用 OrderDetails 。 
在 未 开启 引用 保留 选项 时 ,序列 化 后 得 到 的 XML 文档 如 下 。 


< ArrayOfOrderInfo …> 
<OrderInfo> 
<BuildTime> 2018 — 03 - 27T00:00:00 </BuildTime > 
<DetailsData> 
< ContactName > Lee </ContactName > 
<Price>3.15</Price> 
<Quantity> 12 </Quantity> 
<Weight >17.5 </Weight > 
</DetailsData> 
<OrderNo> 1</OrderNo> 
</OrderInfo> 
<OrderInfo> 
<BuildTime > 2018 — 09 - 02T00:00:00 </BuildTime > 
<DetailsData> 


354 硬 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


< ContactName > Lee </ContactName > 

<Price>3.15 </Price> 
< Quantity> 12 </Quantity> 
<Weight >17.5 </Weight > 

</DetailsData> 

<OrderNo > 2 </OrderNo> 

</OrderInfo> 
</ArrayOfOrderInfo> 


可 以 看 到 ,OrderDetails 实例 的 各 个 属性 值 被 写 信 了 两 次 。 
步骤 4: 对 序列 化 的 代码 进行 修改 ,开启 保留 引用 选项 。 


using (FileStream fs = File.0pen("data.xml"，FileMode. Create) ) 
{ 


DataContractSerializerSettings settings = new DataContractSerializerSettings(); 
settings. PreserveObjectReferences = true; 
DataContractSerializer sz = new DataContractSerializer(ords. GetType(), settings); 
sz, WriteObject(fs, ords); 

} 


先 要 实例 化 一 个 DataContractSerializerSettings 对 象 , 然 后 将 它 的 PreserveObjectReferences 
属性 设置 为 true, 保 留 引用 选项 就 被 启用 了 ,最 后 再 将 DataContractSerializerSettings 对 象 
传递 给 DataContractSerializer 类 的 构造 函数 。 

步骤 5: 运行 应 用 程序 ,保留 对 象 引用 后 生成 的 XML 文档 如 下 。 


< ArrayOfOrderInfo z:Id= "1" z:Size= "2" .> 
<OrderInfo z:Id= "2"> 
<BuildTime > 2018 — 03 - 27T00:00:00 </BuildTime > 
<DetailsData z:Id= "3"> 
< ContactName z:Id= "4"> Lee </ContactName > 
<Price>3.15 </Price> 
< Quantity> 12 </Quantity> 
<Weight > 17.5 </Weight > 
</DetailsData> 
< OrderNo > 1</OrderNo> 
</OrderInfo> 
<OrderInfo z:Id= "5"> 
< BuildTime > 2018 — 09 - 02T00:00:00 </BuildTime > 
<DetailsData z:Ref = "3" i:nil = "true" /> 
<OrderNo> 2 </OrderNo> 
</OrderInfo> 
</ArrayOfOrderInfo> 


此 次 OrderDetails 实例 的 各 个 属性 值 只 写 入 了 一 次 ,第 二 次 是 通过 id 引用 的 , 即 上 述 
XML 文档 中 的 z: Ref 一 "3"。 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 线程 ; 
。 并 行 任 务 ; 


10.1 线程 


实例 284 Sleep 方法 的 妙用 


【导语 】 

Sleep 是 Thread 类 的 静态 方法 ,调用 该 方法 的 线程 ( 即 当 前 线程 ) 会 暂停 指定 的 时 间 。 
到 达 指 定 的 时 间 后 ,线程 重新 被 “唤醒 "。 在 异步 编程 中 ,可 以 使 用 Sleep 方法 来 等 待 其 他 线 
程 完成 某 项 操作 ,但 是 Sleep 方法 不 能 准确 知道 其 他 线程 所 处 理 的 事件 在 什么 时 间 完 成 , 因 
此 Sleep 方法 仅 适 用 于 线程 间 不 需要 精确 同步 的 场合 。 若 需要 精确 同步 ,推荐 使 用 等 待 句 
柄 ,例如 AutoResetEvent 类 。 

Sleep 方法 有 以 下 两 个 重 载 。 

(1) static void Sleep(int millisecondsTimeout); 

该 重 载 接收 一 个 int 类 型 的 参数 ,表示 线程 暂停 的 毫秒 数 。 

(2) static void Sleep(TimeSpan timeout); 

该 重 载 可 以 指定 具体 的 时 间 ,TimeSpan 类 型 的 参数 可 以 设 定 精度 更 高 的 时 间 段 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 输入 以 下 代码 。 


Console. WriteLine(" 这 是 第 一 行文 本 ,3 秒 后 输出 第 二 行文 本 。"); 
Thread. Sleep(3000) ; 
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Console. WriteLine(" 这 是 第 二 行文 本 ,5 秒 后 输出 第 三 行文 本 。"); 
Thread. Sleep( 5000); 
Console. WriteLine(" 这 是 第 三 行文 本 。"); 


上 述 代 码 会 在 控制 台 上 输出 三 行文 本 。 输 出 第 一 ,二 行文 本 之 间 调 用 Sleep 方法 ,使 当 
前 线程 暂停 3 秒 ; 输出 第 二 ,三 行文 本 之 间 调 用 Sleep 方法 ,使 当前 线程 暂停 5 秒 。 
步骤 3: 运行 应 用 程序 ,输出 结果 如 图 10-1 所 示 。 


图 10-1 Sleep 方法 应 用 示例 


实例 285 ”创建 新 线程 


【导语 】 

要 在 应 用 程序 中 创建 新 线程 , 先 实例 化 Thread 类 ,然后 设置 好 相关 的 属性 (例如 
IsBackground 属性 ) ,再 调用 Start 实例 方法 即 可 启动 新 线程 。 

调用 Thread 类 构造 函数 时 需要 传递 一 个 委托 对 象 ,该 委托 对 象 关 联 要 在 新 线程 上 执 
行 的 代码 。Thread 类 构造 函数 接收 以 下 两 种 委托 对 象 。 

第 一 种 是 不 带 参 数 的 , 它 适用 于 无 须 向 新 线程 传递 数据 的 代码 。 格 式 如 下 。 


delegate void Threadstart( ); 


另 一 种 委托 对 象 带 有 一 个 object 类 型 的 参数 ,可 以 将 要 传递 给 新 线程 的 数据 赋值 给 obj 
参数 ,由 于 参数 声明 为 object 类 型 ,因此 它 可 以 接收 各 种 类 型 的 数据 。 格 式 如 下 。 


delegate void ParameterizedThreadStart(object obj); 


对 于 不 需要 传递 参数 的 新 线程 ,直接 调用 Thread 实例 无 参数 版 本 的 Start 方法 启动 ; 
而 对 于 有 数据 要 传递 的 线程 , 则 应 该 调用 以 下 重 载 版 本 的 Start 方法 。 


void Start(object parameter); 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 创建 Thread 实例 。 
Thread th = new Thread(() => 
{ 
Console. ForegroundColor = ConsoleColor.Green; 


Console. WriteLine( $ "正在 {Thread. CurrentThread. Name} 线程 上 执行 :"); 
for(int i = 0; i<5; i++) 
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Console.Write(i + 1 + " "); 
Thread. Sleep(800); 
} 
Console. Write("\n\n"); 
Console. ResetColor(); 
DD); 


在 新 线程 上 执行 代码 时 ,每 通过 一 轮 for 循环 都 调用 一 次 Sleep 方法 让 新 线程 暂停 一 
下 ,可 以 模拟 耗 时 任务 的 情形 。 
步骤 3: 通过 Name 属性 为 新 线程 分 配 一 个 名 称 。 


th. Name = "new thread"; 


步骤 4: 调用 Start 方法 ,启动 线程 。 


th. Start( ); 


步骤 $: 运行 应 用 程序 项 目 ,输出 结果 如 图 10-2 所 示 。 图 10-2 在 新 线程 上 执行 代码 


实例 286 ”启动 新 线程 并 传递 参数 


【导语 】 

实例 化 Thread 类 时 ,调用 带 ParameterizedThreadStart 委托 类 型 参数 的 构造 函数 , 传 
递 给 新 线程 的 参数 最 终 会 传播 到 ParameterizedThreadStart 委托 所 关联 的 方法 上 ,方法 内 
部 的 代码 可 以 从 方法 参数 获得 被 传递 到 新 线程 的 数据 。 由 于 ParameterizedThreadStart 委 
托 只 接收 单个 参数 ,如 果 考 虑 向 新 线程 传递 多 个 对 象 实例 ,就 得 先 将 这 些 对 象 包 装 为 单个 对 
象 ,例如 数组 、 元 组 ,或 者 自 定义 封装 的 类 型 。 

本 实例 将 演示 在 新 线程 中 向 文件 写 入 文本 ,在 主线 程 中 将 文件 名 通过 参数 传递 给 新 
线程 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 字符 串 类 型 的 变量 ,表示 文件 名 。 


string file name = "test.txt"; 


步骤 3: 创建 新 的 Thread 实例 ,注意 构造 函数 中 使 用 的 是 ParameterizedThreadStart 
委托 ( 带 一 个 object 类 型 的 参数 ) 。 


Thread newThread = new Thread(p => 

{ 
string fileName = pas string; 
using (FileStream fs = new FileStream(fileName, FileMode. Create)) 
{ 


using (StreamWriter writer = new StreamWriter(fs)) 


358 | .NET Core 实战 一 -手把手 教 你 学 握 380 个 精彩 案例 


{ 
// 写 入 文本 
writer. WriteLine(" 空 山 新 雨 后 "); 
writer. WriteLine(" 天 气 晚 来 秋 "); 
writer. WriteLine(" 明 月 松 间 照 "); 
writer.WriteLine(" 清 泉 石 上 流 "); 


} 
D; 


注意 : 参数 是 object 类 型 ,在 提取 参数 时 要 注意 类 型 转换 。 字 符 囊 属于 引用 类 型 ,所 以 此 处 
可 以 通过 as 关键 字 进 行 引用 转换 。 


步骤 4: 启动 新 线程 ,并 把 文件 名 传递 给 新 线程 。 
newThread. Start (file name); 


真正 向 新 线程 传递 数据 的 是 在 调用 Start 方法 的 时 候 。 
步骤 5: 调用 Join 方法 ,阻止 主线 程 ,等 待 新 线程 执行 完成 再 继续 。 


newThread. Join( ) 


步骤 6: 运行 应 用 程序 后 ,在 程序 所 在 目录 下 会 找到 test. txt 文件 。 


实例 287 ”等待 线程 信号 一 一 ManualResetEvent 


【导语 】 

抽象 类 WaitHandle 规范 了 线程 之 间 发 送 与 等 待 事件 信号 的 行为 逻辑 。 

线程 之 间 所 执行 的 代码 往往 是 相互 独立 的 ,在 某 些 有 特殊 要 求 的 场合 ,会 使 得 代码 逻辑 
不 可 控 。 例 如 ,A.、B 两 个 线程 分 别 进行 运算 ,但 是 B 线 程 的 运算 开始 之 前 必须 保证 A 线程 
的 运算 已 经 完成 ,这 种 情况 下 ,就 需要 线程 同步 了 。 

线程 同步 的 一 种 解决 方案 就 是 发 送信 号 与 等 待 信号 。 例 如 上 述 例子 ,可 以 在 线程 之 间 
共享 一 个 事件 句柄 ,B 线程 调用 WaitOne 方法 后 会 被 阻止 ,然后 等 待 A 线程 发 送信 号 ; A 
线程 在 完成 其 计算 后 发 出 信号 ,B 线程 收 到 信号 后 才 会 继续 执行 ,这 样 就 可 以 确保 先 执行 A 
线程 的 代码 ,再 执行 B 线程 的 代码 。 

ManualResetEvent 类 是 事件 等 待 句柄 的 一 个 实现 版 本 , 它 的 特点 是 一 一 发 出 事件 信号 
(调用 Set 方 法) 之 后 会 一 直 保持 有 信号 状态 ,此 时 所 有 处 于 等 待 中 的 线程 都 会 继续 执行 。 
要 把 事件 句柄 切换 回 无 信号 状态 ,必须 手动 调用 Reset 方法 。 也 就 是 说 ,ManualResetEvent 
对 象 需要 手动 切换 信号 状态 ,如 果 调用 Set 方法 之 后 忘记 调用 Reset 方法 ,那么 该 事件 句柄 
就 会 一 直 处 于 有 信号 状态 ,所 有 被 阻止 的 线程 都 会 释放 并 继续 执行 。 

本 实例 演示 了 如 何在 新 的 线程 上 计算 从 1 到 100 的 累加 运算 , 即 计算 1 十 2 十 3 十 …… 十 
100 的 总 和 。 主 线程 必须 等 待 新 线程 计算 完毕 后 才能 继续 ,虽然 主线 程 可 以 调用 Sleep 方法 
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来 暂停 一 段 时 间 , 但 是 要 暂停 的 时 间 是 不 可 预知 的 ,因此 本 实例 使 用 事件 等 待 句柄 的 效果 
较 好 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 创建 的 Program 类 中 声明 一 个 ManualResetEvent 类 型 的 私有 字 
段 ,为 了 可 以 在 Main 方法 中 直接 访问 ,字段 可 以 声明 为 静态 字段 。 


static ManualResetEvent mnlEvt = new ManualResetEvent(false); 


注意 : ManualResetEvent 类 的 构造 函数 包含 一 个 bool 类 型 的 参数 ,用 来 标识 事件 句 枉 在 创 
建 时 的 初始 状态 一 一 有 信号 还 是 无 信号 。 本 实例 中 ,主线 程 需要 等 待 另 一 个 线程 计 
算 完成 才能 继续 ,因此 ManualResetEvent 对 象 的 初始 状态 应 该 为 无 信号 ,否则 主线 
程 是 不 会 等 待 的 。 将 参数 设置 为 false 表示 初始 状态 为 无 信号 。 


步骤 3: 创建 新 线程 。 


Thread th = new Thread(() => 
{ 
intn = 1; 
int result = 0; 
while(n <= 100) 
{ 
// 延 时 模拟 
Thread. Sleep(20); 
result += n; 
nt+; 
} 
Console. WriteLine(" 计 算 结果 :{0}"，result); 
mnlEvt. Set(); 
// 发 送信 号 后 又 马上 切换 为 无 信号 状态 
mnlEvt. Reset(); 
}); 


上 述 代 码 中 ,完成 计算 后 需要 调用 Set 方法 ,因为 这 样 主线 程 才 能 收 到 信号 ,随后 可 以 
调用 Reset 方法 来 恢复 到 无 信号 状态 。 在 本 例 中 ,Reset 方法 的 调用 是 可 选 的 ,因为 只 有 一 
个 主线 程 在 等 待 ,并 没有 其 他 线程 被 阻止 ,就 算 不 调用 Reset 方法 也 不 会 影响 线程 同步 。 

步骤 4: 在 主线 程 的 代码 中 ,必须 调用 WaitOne 方法 ,否则 主线 程 是 不 会 进入 等 待 状 
态 的 。 


Console. WriteLine(" 正 在 等 待 线程 计算 ……"); 
mnlEvt. WaitOne( ); 
Console. WriteLine(" 计 算 完毕 !"); 
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步骤 5: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 10-3 所 示 。 请 读者 重点 观察 各 行文 本 的 
输出 顺序 。 


图 10-3 等待 新 线程 完成 累加 运算 


实例 288 ”等 待 线 程 信号 

【导语 】 

与 ManualResetEvent 类 不 同 ,AutoResetEvent 类 在 调用 Set 方法 发 出 信号 之 后 ,会 立 
刻 恢复 为 无 信号 状态 ,不 需要 调用 Reset 方法 。 

本 实例 假设 某 个 任务 将 分 为 三 个 阶段 执行 ,而 且 顺序 不 能 颠倒 ,第 一 阶段 完成 后 再 执行 
第 二 阶段 ,第 二 阶段 完成 后 再 执行 第 三 阶段 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 三 个 AutoResetEvent 类 型 的 私有 字段 ,为 了 便于 在 Main 
方法 中 访问 ,需要 声明 为 静态 字段 。 


AutoResetEvent 


static AutoResetEvent evtl = new AutoResetEvent(false); 
static AutoResetEvent evt2 = new AutoResetEvent(false); 


static AutoResetEvent evt3 new AutoResetEvent (false); 


这 三 个 字段 分 别 用 于 发 送 实 例 任务 中 三 个 阶段 处 理 完成 的 信号 。 
步骤 3: 创建 三 个 线程 ,假设 它们 分 别 代表 任务 中 的 三 个 阶段 ,具体 参考 代码 清单 10-1。 
代码 清单 10-1 三 个 新 线程 


Thread thl = new Thread(() => 
{ 
Console. WriteLine(" 正 在 进行 第 一 阶段 ……"); 
Thread. Sleep(2000); 
Console. WriteLine( "第 一 阶段 处 理 完成 1"); 
// 发 送信 号 
evtl. Set(); 
1); 
Thread th2 = new Thread(() => 
{ 


// 等 待 第 一 阶段 完成 
evt1. WaitOne( ); 
Console. WriteLine(" 正 在 进行 第 二 阶段 … 


第 10 章 ”异步 与 并 行 361 


Thread. Sleep(2000); 
Console. WriteLine(" 第 二 阶段 处 理 完成 1"); 
// 发 出 信号 
evt2. Set(); 
]) 
Thread th3 = new Thread(() => 
{ 
// 等 待 第 二 阶段 完成 
evt2. WaitOne( ); 
Console. WriteLine( "正在 进行 第 三 阶段 ……"); 
Thread. Sleep(2000); 
Console. WriteLine(" 第 三 阶段 处 理 完成 !"); 
// 发 送信 号 
evt3. Set(); 
]) 7 


步骤 4: 依次 启动 三 个 线程 。 

thl. Start(); 

th2. Start(); 

th3. Start(); 

步骤 5: 主线 程 等 待 最 后 一 个 阶段 完成 ( 即 收 到 evt3 
发 送 的 信号 ) 才 能 继续 执行 。 


evt3. WaitOne( ); 图 10-4 等 待 三 个 事件 句柄 的 信号 
Console. WriteLine("\n 已 完成 所 有 操作 。"); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 10-4 所 示 。 


实例 289 多 个 线程 同时 写 一 个 文件 


【导语 】 

作为 公共 基 类 ,WaitHandle 类 公开 了 三 个 比较 实用 的 静态 方法 : 

(1) WaitAny: 调用 此 方法 后 ,当前 线程 将 被 阻止 。 如 果 指 定 的 事件 句柄 数组 中 有 任意 

-个 事件 发 出 信号 , 则 此 方法 将 返回 数组 中 发 出 信号 的 事件 句柄 的 索引 ,并 结束 等 待 。 

(2) WaitAll: 在 指定 的 事件 句柄 数组 中 ,必须 当 所 有 事件 句柄 都 发 出 信号 后 , 才 会 结束 

(3) SignalAndWait: 可 以 直接 切换 两 个 事件 句柄 的 状态 。 

本 实例 演示 了 WaitAll 方法 的 使 用 。 实 例 的 任务 是 把 9 字 节 写 人 到 文件 中 ,这 个 过 程 
是 通过 3 个 线程 来 完成 的 ,并 且 这 些 线程 的 执行 是 无 序 的 。 为 了 保证 9 字 节 能 按照 原 有 的 
顺序 写 和 ,可 以 将 这 些 字 节 序列 进行 “分 段 *, 即 : 第 1 个 线程 写 入 第 1.2、3 字 节 ,第 2 个 线 
程 写 人 第 4.5、6 字 节 ,第 3 个 线程 写 人 第 7.8、9 字 节 。 每 个 线程 只 负责 写 自 己 该 写 人 的 位 
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置 ,就 算 3 个 线程 是 无 序 执行 的 ， 


最 终 也 不 会 破坏 原 有 字 节 的 顺序 。 各 个 线程 对 应 着 一 个 事 


件 句 柄 (本 实例 使 用 AutoResetEvent 类 ) ,只 要 线程 完成 自己 该 做 的 任务 后 ,就 通过 对 应 
的 事件 句柄 发 出 信号 。 主 线程 将 通过 WaitHandle 类 的 WaitAlL 方法 等 待 所 有 线程 执行 


完成 。 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2; 在 Program 类 中 声明 两 个 只 读 的 字段 ,为 了 便于 在 Main 方法 中 访问 ,可 以 声 
明 为 静态 字段 。 这 两 个 字段 分 别 是 要 输出 的 文件 名 和 一 个 字 节 数组 (包含 要 写 进 文件 的 


9 字 节 )。 


// 文件 名 


static readonly string FileName = "demoFile. data"; 


// 要 写 人 文件 的 9 字 节 


static readonly byte[ ] orgBuffer = 


{ 
Ox0C, Ox10, 0x02, 
OxE3, Ox71, OxA2, 
0x13，0xB8，0x06 
]} 


步骤 3: 在 Program 类 中 声明 一 个 静态 字段 一 一 AutoResetEvent 数组 , 它 将 包含 3 个 
元 素 , 可 以 作为 与 执行 线程 相对 应 的 事件 句柄 。 


static AutoResetEvent[] writtenEvents = { 
new AutoResetEvent (false), 


new AutoResetEvent (false), 


new AutoResetEvent (false) 


}; 


步骤 4: 启动 3 个 新 线程 ,每 个 线程 负责 写 3 字 节 。 


for (intn = 0; n<3; nt+) 


{ 


Thread th = new Thread((p) => 


{ 


// 先 把 要 写 的 字 节 复制 出 来 

int currentCount = Convert.ToInt32(p); 

int copyIndex = currentCount * 3; 

byte[ ] tmpBuffer = new byte[3]; 

Array. Copy(orgBuffer, copyIndex, tmpBuffer, 0, 3); 


// 打开 文件 流 
using (FileStream fs 


= new FileStream(FileName, FileMode. OpenOrCreate, FileAccess. 


Write, FileShare. Write)) 


// 定位 流 的 当前 位 置 
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fs. Seek(copyIndex, SeekOrigin. Begin); 
// 写 人 数据 
fs. Write(tmpBuffer, 0, tmpBuffer. Length); 
} 
// 发 出 信号 
writtenEvents[ currentCount]. Set(); 
}); 
// 标识 为 后 台 线 程 
th. IsBackground = true; 
// 启动 线程 
th. Start(n); 


注意 : 由 于 有 多 个 线程 同时 写 入 一 个 文件 ,因此 在 创建 FileStream 实例 时 ,必须 指定 一 个 有 
效 的 FileShare 枚 举 值 ,本 例 中 应 为 Write。 指 定 此 参数 的 目的 是 允许 多 个 线程 同时 
写 一 个 文件 ,否则 会 发 生 错 误 。 


步骤 5: 在 主线 程 中 ,调用 WaitAll 方法 等 待 所 有 事件 句柄 发 出 的 信号 。 传 递 给 方法 的 
参数 就 是 前 面 声明 的 AutoResetEvent 数组 。 


Console. WriteLine(" 等 待 所 有 线程 完成 文件 写 人 …… 有 
WaitHandle. WaitAll (writtenEvents); 
Console. WriteLine( "文件 写 人 完成"); 


步骤 6: 为 了 验证 9 字 节 是 否 正 确 地 写 入 文件 ,在 写 入 完成 后 再 读 出 文件 中 的 字 节 。 


using (FileStream fsin = new FileStream(FileName, FileMode. Open)) 
{ 

byte[ ] buffer = new byte[fsin. Length]; 

fsin. Read(buffer, 0, buffer. Length); 

Console. WriteLine( $ "从 文件 读 出 来 的 字 节 :\n{BitConverter. ToString(buffer)}"); 
} 


步骤 7: 运行 应 用 程序 ,控制 台中 输出 的 内 容 如 图 10-5 所 示 。 


图 10-5 多 个 线程 同时 写 一 个 文件 


可 以 对 比 两 次 输出 的 字 节 数组 ,如 果 相 同 , 说 明 3 个 线程 已 把 字 节 序列 正确 地 写 入 
人 
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实例 290 ”使 用 线程 锁 


【导语 】 

当 多 个 线程 访问 同一 个 对 象 时 ,由 于 线程 之 间 抢 占 资源 ,会 使 数据 状态 不 同步 ,从 而 导 
致意 外 发 生 。 非 常 经 典 的 一 个 案例 就 是 “ 卖 火车 票 ”, 假 设 有 50 张 火车 票 , 有 5 个 线程 同时 
售票 (类 似 于 5 个 售票 窗口 同时 工作 ) ,并 且 各 个 线程 之 间 都 会 抢夺 处 理 器 时 间 片 ,线程 A 
判断 还 剩余 1 张 火车 票 并 正 准 备 售 出 最 后 一 张 票 ,此 时 意外 发 生 ,由 于 在 线程 A 判断 剩余 
票数 与 执行 售票 之 间 存 在 时 间 差 ,而 正好 在 这 段 时 间 里 线程 B 把 最 后 一 张 火车 票 卖 完 了 ， 
造成 线程 A 在 执行 售票 时 竟 发 现 无 票 可 售 。 

这 种 看 似 不 符合 逻辑 的 事情 ,在 异步 编程 中 却 很 容易 遇 到 。 有 时 代码 出 现 错误 后 ,开发 
人 员 不 管 怎么 调试 ,始终 找 不 到 出 错 的 原因 ,这 很 有 可 能 是 忽略 了 异步 操作 中 资源 同步 的 问 
题 。 为 了 避免 关键 的 数据 被 线程 意外 修改 而 引发 错误 ,对 于 被 多 个 线程 访问 的 资源 ,应 当 使 
用 线程 锁 。 当 某 个 线程 即将 使 用 资源 时 , 先 对 资源 上 锁 , 上 锁 之 后 其 他 线程 将 无 法 使 用 该 资 

源 ,只 能 等 到 该 线程 对 资源 解锁 后 才能 访问 。 线 程 锁 可 以 保证 在 同一 时 刻 只 有 一 个 线程 能 
访问 资源 。 在 C# 语 言 中 ,可 以 直接 用 lock 语句 块 来 锁定 资源 ; 在 Visual Basic 语言 中 ,可 
以 使 用 SyncLock 语句 块 来 给 资源 上 锁 ; 在 .NET 框架 中 则 是 以 Monitor 类 来 实现 线程 锁 
的 ,调用 Enter 方法 锁定 资源 ,随后 调用 Exit 方法 解锁 资源 。 

本 实例 演示 了 通过 4 个 线程 来 从 List 实例 中 删除 元 素 。 当 List 实例 的 Count 属性 为 0 
时 ,就 应 该 停止 删除 操作 (因为 List 实例 中 已 经 没有 元 素 了 ) ,代码 每 次 只 删除 一 个 元 素 ,所 
以 在 删除 元 素 之 前 都 要 检查 一 下 Count 属性 是 否 为 0。 当 Count 属性 为 1 时 ( 剩 下 最 后 一 

个 元 素 ) 就 容易 出 现 意外 ,因为 如 果 某 线程 经 过 判断 确定 Count 属性 不 为 0, 但 在 这 个 线程 
执行 删除 元 素 之 前 ,其 他 线程 可 能 意外 地 把 最 后 一 个 元 素 删除 了 ,这 时 候 该 线程 再 执行 删除 
就 会 发 生 错误 。 

这 种 情况 就 需要 线程 锁 了 ,每 一 轮 删 除 操作 中 ,从 判断 Count 属性 到 执行 删除 这 
程 ,当前 线程 都 应 该 将 List 实例 锁定 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 一 个 静态 字段 ,类 型 为 List< int >, 并 为 其 初始 化 。 


static List< int> intList = new List< int >() 

{ 
100, 105, 108, 113, 265, 970, 160, 
410, 303, 302, 104, 103, 102, 921, 
5007 501, 521, 522, 210, 211, 212;, 
213, 214, 175, 174, 376 

}; 


步骤 3: 在 Main 方法 中 ,启动 4 个 新 线程 ,对 List 对 象 执行 RemoveAt 方法 删除 一 个 
元 素 。 


第 10 章 


for (int i = 0; i<4; i++) 
{ 
Thread th = new Thread(() => 


{ 
while (true) 
{ 
if (intList.Count == 0) 
break; 
Thread. Sleep(15); 
intList. RemoveAt(0); 
Console. WriteLine( $ "列表 中 剩余 元 素 {intList. Count} 个 "); 
} 
D); 
th. Start(); 


} 
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步骤 4: 由 于 多 个 线程 共同 访问 的 资源 (此 处 是 List 对 象 ) 没 有 上 锁 ,运行 应 用 程序 就 


会 收 到 如 图 10-6 所 示 的 异常 信息 ,这 正 是 由 于 最 后 一 个 元 素 被 意外 删除 了 。 


用 户 未 处 理 的 异 富 Xx 


System.ArgumentOutOfRangeException Index was out of 
range. Must be non-negative and less than the size of the 
collection.” 


图 10-6 删除 元 素 时 发 生 异 常 
步骤 5: 此 时 要 对 代码 进行 修改 ,加 上 lock 语句 块 。 
for (int i = 0; i<4; i++) 


{ 
Thread th = new Thread(() => 


{ 
while (true) 
{ 
lock (intList) 
和. 
if (intList.Count == 0) 
break; 
Thread. Sleep(15); 
intList. RemoveAt(0); 
Console. WriteLine( $ "列表 中 剩余 元 素 {intList. Count} 个 "); 
} 
} 
]) 
th. Start(); 
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步骤 6: 再 次 运行 应 用 程序 ,就 不 会 收 到 异常 信息 了 ,执行 结果 如 图 10-7 所 示 。 


图 10-7 List 对 象 中 的 元 素 可 以 正确 地 被 删除 了 


10.2 ”并行 任务 


实例 291 ”启动 Task 的 三 种 方法 

【导语 】 

并 行 任务 能 够 充分 利用 多 核 处 理 器 的 资源 ,而 且 由 框架 底层 自动 调配 。 从 综合 性 能 上 
说 ,使 用 Task 更 优 于 Thread。 执 行 新 Task 的 方法 与 Thread 相似 ,也 是 通过 委托 类 型 来 封 
装 要 运行 的 代码 。 本 实例 演示 了 启动 新 Task 的 三 种 方法 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 第 一 种 方法 ,实例 化 Task 类 ,然后 调用 Start 方法 。 


Task taskl = new Task(() => 


{ 

Console. WriteLine(" 任 务 1 已 执行 ."); 
D); 
// 启动 任务 


task1. Start(); 
taskl. Wait(); 
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Wait 方法 的 作用 是 在 当前 线程 上 等 待 该 Task 执行 完成 。 
步骤 3: 第 二 种 方法 ,直接 调用 Task 类 的 Run 静态 方法 。 


Task task2 = Task.Run(() => 
{ 
Console. WriteLine(" 任 务 2 已 执行 。"); 
}); 
task2. Wait(); 


成 功 调用 Run 方法 后 会 返回 一 个 Task 实例 , 它 表示 已 启动 的 并 行 任务 。 
步骤 4: 第 三 种 方法 ,通过 TaskFactory 类 来 创建 新 Task。 


TaskFactory factory = new TaskFactory(); 
Task task3 = factory.StartNew(()=> 
{ 

Console. WriteLine(" 任 务 3 已 执行 。"); 
DD); 
task3. Wait(); 


实例 292” 带 返回 值 的 Task 


【导语 】 

本 实例 演示 了 使 用 并 行 任务 计算 5 的 阶乘 ( 即 1X2X3X4X5), 并 获取 计算 结果 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 Task 类 的 Run 方法 启动 新 任务 ,并 在 执行 的 委托 中 ,将 计算 结果 返回 。 


var task = Task.Run(() => 
{ 
longr = 1L; 
In = 1 
while(t <= 5) 
{ 
和 
七 + 十 
} 
return r; 


]) 
由 于 并 行 任务 有 返回 值 , Run 方法 会 根据 return 语句 推断 出 返回 类 型 为 Task 


< long>。 
步骤 3: 等 待 任务 完成 ,然后 获得 计算 结果 。 


task. Wait( ); 
long result = task.Result; 
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步骤 4: 运行 应 用 程序 ,控制 台 输 出 的 内 容 如 下 。 


5 的 阶乘 :120 
实例 293 ”传递 状态 数据 
【导语 】 


在 启动 新 Task 时 ,可 以 传递 一 个 object 类 型 的 对 象 实例 作为 状态 数据 (可 以 认为 是 输 
入 参数 ) 。 由 于 所 需 类 型 是 object, 因 此 可 以 传递 各 种 数据 类 型 。 

本 实例 将 演示 将 二 元 组 实例 传递 给 新 的 Task ,并 在 并 行 代码 中 读 出 其 中 的 数据 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 二 元 组 ,其 中 包含 string 和 int 类 型 的 值 。 


var state = (Name: "Jack", Age: 28); 
步骤 3: 创建 Task 实例 ,将 上 述 二 元 组 作为 状态 数据 传递 。 


Task 七 = new Task(s => 
{ 
// 读 取 状态 数据 
(string name, int age) = ((string, int))s; 
Console. WriteLine( $ "Name: {name}\nAge: {age}"); 
}, state); 


以 下 重 载 版 本 的 构造 函数 支持 输入 状态 数据 : 
public Task(Action < object > action, object state); 


其 中 ,由 于 要 在 执行 代码 中 接收 状态 数据 ,所 以 需要 使 用 一 个 带 object 类 型 参数 的 委托 
类 型 。 
步骤 4: 启动 并 行 任务 ,然后 等 待 其 完成 。 


t. Start(); 
七 . Wait(); 


步骤 5: 运行 应 用 程序 ,从 状态 数据 中 读 到 的 内 容 如 下 。 


Name: Jack 
Age: 28 


实例 294 ”串联 并 行 任务 


【导语 】 
在 一 些 复杂 的 处 理 逻 辑 中 ,经 常会 执行 多 个 并 行 任务 ,并 且 这 些 任 务 都 需要 按照 一 定 的 
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顺序 执行 ,在 这 种 情况 下 ,把 并 行 任务 进行 串联 比 等 待 事件 句柄 信 号 更 简单 。 

Task 类 公开 ContinueWith 实例 方法 ,调用 该 方法 后 ,会 将 当前 任务 与 下 一 个 要 执行 的 
任务 串联 ,当前 任务 执行 完成 后 就 会 启动 下 一 个 任务 。ContinueWith 方法 返回 Task 实例 ， 
即 串联 执行 的 新 任务 ,并 且 ContinueWith 方法 可 以 连续 调用 ,例如 以 下 方式 。 


myTask. ContinueWith( … ) 
. ContinueWith( … ) 
,. ContinueWith( … ) 


本 实例 将 演示 通过 三 个 Task 进行 加 法 运算 ,第 一 个 Task 返回 整数 值 10 ,第 二 个 Task 
在 第 一 个 Task 返回 值 的 基础 上 再 加 上 15 并 返回 ,第 三 个 Task 在 第 二 个 Task 所 返回 的 结 


果 上 再 加 上 20 并 返回 计算 结果 。 这 三 个 Task 必须 按照 顺序 执行 ,因此 应 该 调用 
ContinueWith 方法 进行 串联 。 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 串联 执行 三 个 并 行 任务 ,最 终 返回 给 task 变量 的 是 最 后 执行 的 Task 所 返回 的 
结果 。 


Task< int > task = Task.Run(() => 10) // 返 回 10 
.ContinueWith(lasttask => lasttask. Result + 15) // 返回 25 
.ContinueWith(lasttask => lasttask. Result + 20); // 返回 45 


步骤 3: 等 待 并 行 任务 完成 。 


task. Wait( ); 


步骤 4: 运行 应 用 程序 ,最 后 的 输出 结果 如 下 。 

计算 结果 :45 

实例 295 ”使 用 Parallel 类 执行 并 行 操作 
【导语 】 


Parallel 类 是 一 个 轻 量 级 的 并 行 操作 执行 类 ,主要 用 在 基于 for 或 foreach 循环 的 并 行 
代码 上 ,该 类 会 充分 调配 处 理 器 的 资源 来 运行 循环 ,提升 性 能 。 

本 实例 将 使 用 Parallel 类 启动 并 行 的 foreach 循环 来 向 文件 写 数据 ,每 一 轮 循 环 负责 写 
一 在 交 件 ， 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 一 个 字符 串 数组 实例 ,包含 要 创建 的 文件 名 列表 。 


string[ ] fileNames = 
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"demo 1 dx", "demo 2 dx", "demo 3 dx", "demo 4 dx", 
"demo 5_dx", "demo 6 dx", "demo 7_dx", "demo 8_dx" 
}; 


步骤 3: 调用 Parallel. ForEach 方法 循环 写 文 件 ,文件 长 度 以 及 字 节 序列 均 随 机 产生 。 


Random rand = new Random(); 
Parallel. ForEach(fileNames, (fn) => 
{ 
int len; 
byte[ ] data; 
lock (rand) 
{ 
// 随机 产生 文件 长 度 
len = rand. Next(100, 90000); 
data = new byte[ len]; 
// 生成 随机 字 节 序列 
rand. NextBytes( data); 
} 
using(FileStream fs = new FileStream(fn, FileMode.Create)) 
{ 
fs. Write(data); 
} 
Console. WriteLine( $ "已 向 文件 {fn} 写 入 {data. Length} 字 节 "); 
WD 


步骤 4: 运行 应 用 程序 ,执行 结果 如 图 10-8 所 示 。 


图 10-8 并 行 写 文 件 


10.3 异步 等 待 语法 


实例 296 ”声明 异步 方法 

【导语 】 

异步 等 待 语法 主要 由 一 对 语言 关键 字 组 成 : async 和 await, 这 两 个 关键 字 通 常 是 成 对 
出 现 的 。 要 让 方法 支持 异步 等 待 ,必须 要 让 方法 的 返回 类 型 为 Task 或 者 Task < TResult >。 
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方法 的 名 称 可 以 用 “Async” 结 尾 , 以 标注 它 是 异步 方法 ,例如 RunAsync、DownloadAsync 等 。 

调用 异步 方法 时 ,可 以 加 上 await 关键 字 , 表 示 异 步 等 待 。 在 调用 异步 方法 时 ,当前 线 
程 会 进入 等 待 状态 ,但 不 会 阻塞 ; 当 异 步 方法 执行 完成 后 ,会 回 到 当前 线程 中 并 继续 执行 后 
面 的 代码 。 在 使 用 了 await 关键 字 的 方法 中 需要 加 上 async 关键 字 , 表 示 调 用 了 异步 代码 。 

综 上 所 述 ,异步 方法 的 声明 方法 就 是 让 它 返 回 Task 或 Task < TResult > 实例 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 异步 方法 WorkAsync。 在 方法 内 部 ,直接 通过 Task. Run 方法 返回 Task 
对 象 。 

static Task WorkAsync() 


{ 
return Task. Run( () => Console. WriteLine(" 执 行 异步 代码 …… 六 


上 
步骤 3: 可 以 用 await 关键 字 调 用 上 述 异 步 方法 。 


static async void Test() 
{ 


await WorkAsync( ); 
} 
由 于 Test 方法 中 调用 了 异步 方法 ,所 以 要 使 用 async 关键 字 来 修饰 Test 方法 。 
步骤 4: 声明 异步 方法 时 ,还 可 以 创建 Task 实例 ,然后 将 其 返回 。 


static Task SomeAsync() 

{ 
Task t = new Task(() => Console. WriteLine(" 做 些 事情 ")); 
七 . Start(); 
return t; 


注意 : 创建 Task 实例 后 ,在 返回 之 前 必须 要 调用 Start 方法 启动 任务 ,否则 await 关键 字 无 
法 等 待 未 运行 的 任务 。 如 果 在 异步 方法 中 创建 的 新 Task 实例 没有 启动 ,可 以 在 调用 
异步 方法 时 获取 该 Task 实例 的 引用 ,然后 手动 调用 Start 启动 任务 ,再 用 await 关键 
字 异 步 等 待 任务 完成 ,具体 实现 如 下 。 

Task task = SomeAsync(); 

task. Start( ) 7 

await task; 

从 代码 封装 的 角度 看 ,不 推荐 这 样 做 ,最 合适 的 做 法 是 在 异步 方法 返回 之 前 启动 并 行 
任务 ,这 样 会 显得 比较 友好 ,方便 后 续 使 用 封装 好 的 代码 。 
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实例 297 在 Main 方法 中 使 用 异步 等 待 

【导语 】 

新 版 本 (7. 1 或 以 上 版 本 ) 的 C# 语 言 支持 在 Main 方法 中 进行 异步 等 待 ,使 用 方法 为 : 在 
Main 方法 中 使 用 await 关键 字 调 用 异步 方法 ,然后 在 Main 方法 中 添加 async 关键 字 进 行 修饰 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 本 例 以 Task. Delay 方法 的 调用 来 做 演示 ,此 方法 也 会 返回 一 个 Task 实例 ,在 
Main 方法 中 输入 以 下 代码 。 

Console. WriteLine(" 先 等 2 秒 。"); 

await Task. Delay(2000); 

Console. WriteLine(" 再 等 3 秒 。"); 

await Task. Delay(3000); 


Console. WriteLine(" 还 要 等 4 秒 。"); 
await Task. Delay(4000); 


步骤 3: 在 Main 方法 上 添加 async 修饰 符 。 


static async Task Main(string[ ] args) 
{ 


} 


注意 : 如 果 Main 方法 返回 的 类 型 为 void, 请 将 其 改 为 Task, 目 前 只 支持 返回 Task 或 Task 
<int > 类 型 。 


步骤 4: (如果 编译 错误 , 则 需要 执行 此 步骤 ) 打 开 项 目 属性 ,切换 到 “生成 ”选项 卡 , 单 击 
页 面 下 方 的 “高 级 "按钮 。 在 打开 的 “高 级 生成 选项 "窗口 中 ,将 语言 版 本 设置 为 7. 1 或 更 高 
版 本 ,或 者 选择 “C# 最 新 次 要 版 本 (最 新 )”, 如 图 10-9 所 示 。 


高 级 生成 设置 ? x 
军 规 
语言 版 本 (U: Ce# 时 新 次 要 版 本 ( 量 新 ) 可 
内 部 编译 器 错误 报告 人 ): ”提示 | 
口 检 到 芒 上 /FO 
输出 
请 二 信息 (6): 可 附 杆 v| 
文件 对 齐 (: S12 a | 
库 基 址 (B): 0x00400000 
[| 


图 10-9 选择 语言 版 本 
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步骤 5: 运行 应 用 程序 ,控制 台 输 出 结果 如 下 。 


先 等 2 秒 。 
再 等 3 秒 。 
还 要 等 4 秒 。 


实例 298 ”为 每 个 线程 单独 分 配 变 量 值 


【导语 】 

在 某 些 应 用 场景 下 ,对 于 同一 个 变量 ,需要 允许 访问 它 的 各 个 线程 都 保留 独立 的 值 , 即 
在 使 用 同一 个 变量 的 情况 下 ,每 个 线程 可 以 为 该 变量 分 配 独立 的 变量 值 ,这 些 值 只 在 当前 线 
程 中 有 效 。 

要 实现 这 样 的 需求 ,就 要 借助 ThreadLocal < T > 类 ,该 类 的 实例 可 以 在 多 个 线程 之 间 
共享 ,并且 每 个 线程 可 以 通过 Value 属性 设置 各 自 的 值 ,线程 与 线程 之 间 互 不 干扰 。 如 果 需 
要 知道 ThreadLocal 变量 被 设置 过 哪些 值 ,可 以 访问 Values 属性 ,要 使 Values 属性 可 用 ， 
在 调用 ThreadLocal 类 的 构造 函数 时 ,需要 调用 带 有 trackAllValues 参数 (bool 类 型 ) 的 重 
载 版 本 ,并 将 trackAllValues 参数 设置 为 true。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 一 个 ThreadLocal < int > 类 型 的 静态 字段 ,并 初始 化 。 


static ThreadLocal < int > _localvar = new ThreadLocal < int >(true); 


本 实例 稍 后 会 访问 Values 属性 ,所 以 在 调用 ThreadLocal 类 构造 函数 时 要 将 
trackAllValues 参数 设置 为 true。 
步骤 3: 创建 三 个 新 线程 ,并 在 线程 所 执行 的 代码 上 修改 ThreadLocal 实例 的 Value 属性 。 


Thread thl = new Thread(() => 

{ 
_localvar. Value = 5000; 
Console. WriteLine( $ "在 ID 为 {Thread. CurrentThread. ManagedThreadId} 的 线程 ,本 地 线程 变 
量 的 值 为 :{_localvar. Value}"); 

}); 

th1. Start(); 


Thread th2 = new Thread(() => 

{ 
_localvar. Value = 9000; 
Console. WriteLine( $ "在 ID 为 {Thread. CurrentThread. ManagedThreadId} 的 线程 ,本 地 线程 变 
量 的 值 为 :{_localvar. Value}"); 

D; 

th2. Start(); 
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Thread th3 = new Thread(() => 
{ 


_localvar. Value = 7500; 
Console. WriteLine( $ "在 ID 为 {Thread. CurrentThread. ManagedThreadId} 的 线程 , 本 地 线程 变 
量 的 值 为 :{_localvar. Value}"); 

]) 

th3. Start() 


步骤 4: 等 待 三 个 线程 执行 完成 。 


thl. Join(); 
th2. Join(); 
th3. Join(); 


步骤 5: 此 时 ,在 主线 程 代码 中 可 以 访问 Values 的 属性 , 枚 举 出 被 设置 过 的 值 。 
Console, WriteLine("\n 设 置 过 的 所 有 值 :"); 


foreach (int n in _localvar. Values) 


{ 


Console. Write(" {0}", n); 


} 
步骤 6: 运行 应 用 程序 ,得 到 的 结果 如 图 10-10 所 示 。 


10-10 ”基于 线程 的 本 地 变量 


实例 299 保留 异步 上 下 文中 的 本 地 变量 值 

【导语 】 

在 基于 Task 的 异步 等 待 上 下 文中 ,ThreadLocal < T > 类 型 的 本 地 变量 无 法 发 挥 作用 ， 
请 思考 以 下 例子 。 


ThreadLocal < string > local = new ThreadLocal < string>() 7 
async Task WorkAsync() 
{ 
local. Value = "hello"; 
Console. WriteLine(" 异 步 等 待 前 :{0}",， local. Value); 
await Task. Delay(150); 
Console. WriteLine(" 异 步 等 待 后 :{0}"，local. Value); 
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在 进入 异步 等 待 前 ,本 地 变量 将 字符 串 常 量 赋值 为 “hello”, 随 后 调用 Delay 方法 ,并 异 
步 等 待 方法 返回 。 回 到 当前 上 下 文 后 ,本 地 变量 的 值 变 为 默认 值 (字符 串 的 默认 值 是 null)， 
也 就 是 说 ,之 前 赋值 的 字符 串 “hello” 已 经 读 不 到 了 。 

这 是 因为 基于 并 行 任务 的 异步 上 下 文 是 由 内 部 框架 自动 调度 的 ,异步 等 待 前 后 ,本 地 变 
量 可 能 处 于 不 同 的 线程 上 , 即 await 语句 使 用 前 后 的 代码 并 不 是 在 同一 个 线程 上 ,所 以 在 等 
待 方法 返回 后 就 取 不 到 本 地 变量 的 值 了 。 要 解决 这 个 问题 ,可 以 用 AsyncLocal < T > 类 替 
换 ThreadLocal < 本 > 类 。AsyncLocal <T> 类 能 够 在 异步 上 下 文 之 间 保 留 原 有 的 数据 , 即 
使 异步 等 待 前 后 的 代码 不 在 同一 个 线程 上 ,也 能 够 访问 之 前 设置 的 值 。 

以 下 实例 将 演示 AsyncLocal< T> 类 的 用 法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 一 个 静态 字段 ,类 型 为 AsyncLocal < string >。 


static AsyncLocal < string> local = new RsyncLocal < string>(); 


步骤 3: 定义 一 个 异步 方法 ,在 方法 内 部 调用 Task. Delay 方法 ,并 异步 等 待 方法 返回 。 
进入 异步 等 待 前 ,对 local 变量 赋值 ; 异步 等 待 返回 后 , 读 出 local 变量 的 值 。 

static async Task RunThisCodeAsync() 

{ 


local. Value = "Follow me"; 

Console. WriteLine(" 异 步 等 待 前 :{0}"，local. Value); 

await Task. Delay(150); 

Console. WriteLine(" 异 步 等 待 后 :{0}"，local. Value); 
} 


步骤 4: 在 Main 方法 中 调用 RunThisCodeAsync 方法。 
RunThisCodeAsync(). Wait(); 
步骤 5: 运行 应 用 程序 ,控制 台 输出 内 容 如 下 。 


异步 等 待 前 :Follow me 
异步 等 待 后 :Follow me 


可 以 看 到 ,等 待 之 前 所 赋 的 值 ,在 异步 上 下 文 返回 后 仍然 能 顺利 地 读 取 。 

实例 300 取消 并 行 任务 

【导语 】 

在 实际 开发 中 ,经 常会 遇 到 在 后 台 使 用 Task 执行 一 些 比较 耗 时 间 代码 的 情况 。 出 于 
友好 的 用 户 体验 考虑 ,在 执行 长 时 间 任 务 的 过 程 中 应 该 向 用 户 反 馈 处 理 进 度 ; 此 外 ,由 于 运 


行 耗 时 较 长 ,用户 可 能 不 想 再 继续 等 待 ,应 该 允许 用 户 取 消 任务 。 
CancellationTokenSource 类 提供 了 取消 任务 的 处 理 模型 ,通过 Token 属性 可 以 获得 
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CancellationToken 结构 实例 的 副本 。 所 有 被 复制 的 CancellationToken 对 象 都 会 监听 
CancellationTokenSource 实例 的 状态 ,一 旦 CancellationTokenSource 实例 调用 了 Cancel 
方法 ,各 个 CancellationToken 副本 就 会 收 到 通知 , 此 时 CancellationToken 对 象 的 
IsCancellationRequested 属性 就 会 返回 true。 可 以 通过 检查 IsCancellationRequested 属性 
来 判断 并 行 任务 是 否 被 取消 。 

本 实例 将 演示 一 个 累加 运算 ,计算 过 程 用 一 个 异步 方法 封装 。 调 用 方法 时 ,可 以 传递 一 
个 整数 值 ,表示 参与 累加 运算 的 最 大 值 ,计算 将 从 0 开始 累加 ,直到 最 大 值 ,例如 ,最 大 值 为 
5, 那 么 就 计算 0 十 1 十 2 十 3 十 4 十 5。 在 程序 执行 运算 的 过 程 中 ,用 户 随时 可 以 按 下 C 键 取消 


任务 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 用 于 执行 累加 计算 的 异步 方法 。 


static Task < int > RunAsync( int maxNum, CancellationToken token = default) 


{ 


} 


TaskCompletionSource< int > tcl = new TaskCompletionSource< int >(); 
int x = 0; 
int res = 0; 
while(x < maxNum) 
{ 
if (token. IsCancellationRequested) 
{ 


break; 
} 
res += x; 
x += 1; 


Task. Delay(500). Wait(); 
} 
tcl. SetResult (res); 
return tcl. Task; 


token 参数 用 于 监听 任务 是 否 被 取消 。 本 方法 中 使 用 了 TaskCompletionSource 
< TResult > 类 ,这 个 类 可 以 灵活 地 设置 Task 的 运行 结果 (通过 SetResult 方法 设置 ) ,再 访 
问 Task 属性 就 能 获取 要 返回 的 并 行 任务 实例 。 

步骤 3: 在 Main 方法 中 实例 化 CancellationTokenSource。 


CancellationTokenSource cansrc = new CancellationTokenSource(); 


步骤 4: 在 调用 累加 计算 的 异步 方法 之 前 ,可 以 开启 一 个 并 行 任务 ,用 于 判断 用 户 是 否 
按 下 了 C 键 , 如 果 是 ,就 调用 CancellationTokenSource 对 象 的 Cancel 方法 。 
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Task. Run(() => 
{ 
Console. WriteLine(" 按 C 键 取消 任务 ."); 
while (true) 
{ 
var info = Console.ReadKey(true); 
if (info.Key == ConsoleKey.C) 
{ 
cansrc. Cancel ( ); 
break; 


} 

D); 

步骤 5: 调用 异步 方法 ,并 等 待 计算 完成 。 

int result = await RunAsync(200, cansrc.Token); 

Console. WriteLine(" 计 算 结 果 :{0}",， result); 

访问 Token 属性 ,会 复制 一 份 CancellationToken 实例 ,并 能 够 监听 Cancel 方法 的 
调用 。 

步骤 6: 当 不 再 使 用 CancellationTokenSource 对 象 时 ,需要 将 其 释放 。 


cansrc. Dispose( ); 


步骤 7: 运行 应 用 程序 ,累加 计算 开始 。 此 过 程 中 如 果 按 下 C 键 ,任务 被 取消 ,并 把 已 
经 完成 的 部 分 计算 结果 返回 ,如 图 10-11 所 示 。 


图 10-11 已 取消 的 并 行 任务 


网 络 编程 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 基于 Socket 的 网 络 通信 ; 
。 HTTP 编程 。 


11.1 Socket 通信 


实例 301 简单 的 TCP 通信 程序 


【导语 】 

TCP 是 基于 连接 的 通信 协议 ,Socket 可 以 视 为 两 个 终结 点 之 间 用 于 对 话 的 标识 。 

一 般 来 说 ,在 服务 器 上 至 少 需 要 两 个 Socket 实例 来 完成 通信 工作 。 一 个 Socket 实例 
会 绑 定 服务 器 主机 的 地 址 和 端口 ,然后 监听 客户 端的 连接 , 当 收 到 客户 端的 连接 后 ,会 产生 
另 一 个 Socket 实例 ,此 Socket 实例 主要 负责 双方 的 通信 , 即 在 服务 器 与 客户 端 之 间 发 送 和 
接收 数据 。 在 客户 端 主机 上 ,通常 只 需要 一 个 Socket 实例 ,该 Socket 实例 首先 要 向 服务 器 
发 起 连接 请 求 ,连接 成 功 后 就 可 以 与 服务 器 通信 了 。 

【操作 流程 】 

以 下 为 服务 器 的 实现 部 分 。 

步骤 1: 创建 用 于 监听 连接 的 Socket 实例 。 


Socket server = new Socket(SocketType. Stream, ProtocolType. Tcp); 
步骤 2: 绑 定 本 地 终结 点 。 本 实例 中 将 绑 定 到 本 地 环 回 地 址 (IP 为 127. 0. 0. 1) ,端口 号 
为 6000。 


// 本 地 监听 地 址 

IPEndPoint localSv = new IPEndPoint(IPAddress. Loopback, 6000); 
// 绑 定 本 地 端点 

server. Bind( localSv); 
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步骤 3: 调用 Listen 方法 ,开始 监听 连接 。 
server. Listen(10); 


Listen 方法 有 一 个 backlog 参数 ,用 于 指定 队列 中 等 待 的 连接 数 ,此 数值 根据 实际 情况 
设 定 , 本 实例 中 设 定 为 10。 

步骤 4: 调用 Accept 方法 。 调 用 之 后 服务 器 Socket 会 处 于 等 待 状态 ,一 旦 接收 到 客户 
端的 连接 ,就 会 返回 一 个 新 的 Socket 实例 ,该 Socket 实例 将 用 于 通信 。 


Socket client = server.Accept(); 
步骤 5: 此 时 可 以 进行 通信 了 ,本 例 仅 向 客户 端 发 送 一 条 字符 串 消息 。 


string message = "你 好 ,我 是 服务 器 。"; 

byte[ ] data = Encoding. UTF8.GetBytes(message); 

// 发 送 数 据 长 度 

client. Send(BitConverter. GetBytes(data. Length) ); 

// 发 送 数 据 正 文 

client. Send(data); 

发 送 数据 调用 Send 方法 ,数据 都 是 以 字 节 序列 形式 发 送 的 ,因此 字符 串 内 容 要 先 转换 
为 字 节 序列 。 

由 于 通信 和 是 基于 流 的 方式 处 理 的 ,数据 均 为 连接 的 字 节 序列 ,容易 出 现 “ 粘 包 ” 现 象 , 即 
前 一 条 消息 可 能 与 后 一 条 消息 混合 在 一 起 了 ,导致 无 法 判断 数据 的 具体 长 度 。 因 此 ,比较 保 
险 的 方案 是 先 把 数据 正文 的 长 度 发 送 过 去 (一 般 为 int 值 或 long 值 ) ,然后 再 发 送 数据 正文 ; 
接收 方 在 读 取 数 据 时 ,可 以 先 读 取 数 据 长 度 , 然 后 再 读 取 数 据 正文 ,这 样 可 以 保证 数据 传输 
的 准确 性 。 

步骤 6: 关闭 Socket 对 象 ,释放 资源 。 


client. Close(); 
server. Close( ); 


以 下 是 客户 端的 实现 部 分 。 

步骤 7: 在 客户 端 上 创建 Socket 实例 。 客 户 端 上 一 般 只 需要 单个 Socket 实例 即 可 完 
成 通信 。 

Socket client = new Socket(SocketType. Stream, ProtocolType. Tcp); 


步骤 8: 调用 Connect 方法 ,向 服务 器 发 起 连接 。 


client. Connect( IPAddress. Loopback, 6000); 


注意 : 客户 端 在 发 起 连接 时 ,请 确保 所 指定 的 地 址 和 端口 号 与 服务 器 所 绑 定 的 地 址 和 端口 
号 匹配 。 
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步骤 9: 读 取 数据 长 度 。 


byte[ ] data = new byte[ sizeof(int)]; 
int dataLen = 0; 
int n = client. Receive(data); 
if(n == data. Length) 
{ 
dataLen = BitConverter.ToInt32(data, 0); 


» 

服务 器 发 送 的 数据 长 度 是 int 类 型 ,为 4 字 节 ,在 读 取 后 也 要 相应 地 转换 为 int 类 型 。 
步骤 10: 读 取 数 据 正文 ,并 解析 出 字符 串 。 

data = new byte[ dataLen]; 

client. Receive(data); 


string msg = Encoding.UTF8.GetString(data); 
Console. WriteLine( $ "\n 客户 端 收 到 服务 器 的 消息 :\n{msg}"); 


步骤 11: 断 开 连 接 。 

client. Disconnect (false); 

Disconnect 方法 需要 一 个 reuseSocket 参数 , 表 
示 稍 后 是 否 还 能 继续 使 用 该 Socket 实例 。 在 本 例 
中 ,通信 已 经 完成 ,无 须 再 使 用 该 Socket 实例 ,因此 
可 以 指定 为 false。 

步骤 12: 关闭 Socket 对 象 ,释放 资源 。 


国 cNprogram Files\dotne... 


client. Close( ); 
步骤 13: 运行 应 用 程序 ,控制 台 输出 结果 如 
图 11-1 所 示 。 


11-1 TCP 通信 示例 


实例 302 TcpListener 与 TcpClient 


TcpListener 类 与 TcpClient 类 是 框架 提供 的 封装 类 型 ,它们 包装 了 基于 TCP 协议 的 
Socket 通信 ,使 网 络 编程 变 得 更 简单 。 

TcpListener 类 负责 两 件 事 : 一 是 开启 或 停止 监听 来 自 客户 端的 连接 请 求 ; 二 是 接受 
连接 ,并 产生 一 个 新 的 TcpClient 实例 (用 于 通信 )。 

TcpClient 类 仅 用 于 发 送 或 接收 消息 。 在 服务 器 上 ,该 类 的 实例 由 TcpListener 实例 的 
AcceptTcpClient 方法 返回 ; 在 客户 端 ,只 需要 使 用 单个 TcpClient 实例 即 可 完成 通信 ,但 在 
通信 之 前 要 调用 Connect 方法 连接 服务 器 。 经 过 封装 后 ,TcpClient 类 将 以 流 的 方式 发 送 和 
接收 数据 , 这 使 得 数据 传输 变 得 更 易于 掌控 。 建 立 连接 后 ,调用 TcpClient 实例 的 
GetStream 方法 ,得 到 一 个 NetworkStream 实例 。NetworkStream 类 从 Stream 类 派生 ,可 
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以 很 方便 地 写 和 或 读 取 字 节 序列 。 

本 实例 将 演示 以 下 通信 功能 : 服务 器 使 用 TcpListener 类 进行 监听 ,客户 端 用 
TcpClient 类 发 起 连接 请 求 。 当 连接 建立 之 后 ,客户 端 发 送 一 条 文本 消息 给 服务 器 ,服务 器 
接收 到 消息 后 将 其 输出 到 控制 台 。 

【操作 流程 】 

以 下 是 服务 器 部 分 。 

步骤 1: 创建 TcpListener 实例 ,监听 端口 为 1763 ,地 址 为 本 地 计算 机 的 任意 地 址 。 


TcpListener server = new TcpListener(IPAddress. Any, 1763); 
步骤 2: 调用 Start 方法 ,开始 监听 。 

server. Start() 

步骤 3: 等 待 客户 端的 连接 。 

TcpClient client = server,AcceptTcpClient(); 

步骤 4: 建立 连接 后 , 读 取 从 客户 端 发 来 的 消息 。 


using(NetworkStream stream = client.GetStream( ) ) 
{ 

List<byte> data = new List <byte>(); 

byte[ ] buffer = new byte[256]; 

intn = 0; 

while((n = stream.Read(buffer)) != 0) 

{ 

data. AddRange( buffer. Take(n)); 


} 
// 转换 为 字符 串 
string msg = Encoding. UTF8.GetString(data. ToArray()); 
Console. WriteLine( $"\n 来 自 客户 端的 消息 :{msg}"); 
} 


步骤 5: 调用 Stop 方法 ,停止 监听 。 
Server. Stop(); 


以 下 为 客户 端 部 分 。 
步骤 6: 创建 TcpClient 实例 。 


TcpClient client = new TcpClient(); 
步骤 7: 向 服务 器 发 起 连接 请 求 。 
client. Connect(IPAddress. Parse("127.0.0.1"), 1763); 


步骤 8: 向 服务 器 发 送 消 息 。 
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using(NetworkStream stream = client. GetStream() ) 
{ 
string ct = ".NET Core 网 络 编程 "; 
byte[ ] data = Encoding. UTF8.GetBytes(ct); 
stream. Write(data); 
} 
步骤 9: 运行 应 用 程序 ,可 以 从 控制 台 的 输出 图 11-2 ”从 客户 端 发 来 的 消息 
中 看 到 服务 器 所 接收 到 的 消息 ,如 图 11-2 所 示 。 


实例 303 ”使 用 UdpClient 类 开发 简单 的 聊天 程序 


【导语 】 

UdpClient 类 是 一 个 封装 类 ,包含 了 Socket 上 UDP 协议 与 通信 相关 的 功能 ,使 基于 
UDP 协议 的 通信 编程 更 简单 。 由 于 UDP 协议 是 无 连接 .无 序 的 ,因此 只 需要 单个 
UdpClient 实例 即 可 完成 通信 。 在 收发 数据 之 前 无 须 建立 连接 ,直接 调用 Send 方法 就 可 以 
将 数据 发 送 到 指定 主机 的 特定 端口 上 上。 数据 接收 方 也 可 以 直接 调用 Receive 方法 接收 远程 
主机 发 来 的 消息 。 

为 了 便于 理解 ,本 实例 仅 实现 了 单 向 聊天 程序 , 即 服务 器 只 负责 接收 并 显示 消息 ,客户 
端 只 能 用 于 发 送 消息 。 

【操作 流程 】 

以 下 为 服务 器 的 实现 步骤 。 

步骤 1: 实例 化 UdpClient 对 象 。 


UdpClient udpServer = new UdpClient(9000); 

上 述 代码 调用 了 带 一 个 int 类 型 参数 的 构造 函数 ,port 参数 指定 服务 器 用 于 接收 数据 
的 本 地 端口 号 , 若 未 指定 本 地 地 址 则 表明 服务 器 会 监听 本 地 计算 机 上 的 所 有 地 址 。 

步骤 2: 通过 一 个 循环 来 不 断 接收 消息 , 遇 到 “end” 消 息 时 退出 。 


while(true) 


{ 


UdpReceiveResult result = await udpServer. ReceiveAsync(); 


string msg = Encoding. UTF8.GetString(result. Buffer); 
// 如 果 消 息 是 “end”, 表示 退出 
if (msg. ToLower().Equals("end")) 
{ 
break; 


} 
// 否则 显示 收 到 的 消息 
string host = result.RemoteEndPoint. Address. MapToIPv4().ToString(); 


Console. WriteLine( $ "来 自 {host} :{msg}"); 
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步骤 3: 调用 Close 方法 关闭 通信 通道 。 
udpServer. Close( ); 


以 下 为 客户 端的 实现 步骤 。 
步骤 4: 创建 UdpClient 实例 。 


UdpClient udpClient = new UdpClient(); 
步骤 5: 以 下 变量 表示 服务 器 的 主机 名 与 端口 号 。 
// 服务 器 主机 名 


string serverHost = "127.0.0.1"; 
// 服务 器 端口 号 


int serverPort = 9000; 
步骤 6: 通过 循环 允许 用 户 发 送 多 条 消息 。 要 发 送 的 消息 来 自 键盘 输入 ,如 果 遇 到 end 
就 退出 。 
while (true) 
{ 
Console. Write(" 请 输入 消息 内 容 :"); 
string msg = Console. ReadLine(); 
byte[ ] data = Encoding.UTF8.GetBytes(msg); 
udpClient. Send( data, data.Length, serverHost, serverPort); 
// 如 果 是 “end” 则 退出 
if (msg. ToLower().Equals("end")) 
{ 
break; 
} 
} 


步骤 7: 最 后 关闭 通信 通道 。 
udpClient. Close( ); 


步骤 8: 运行 应 用 程序 ,在 客户 端 应 用 程序 中 = se, 
输入 要 发 送 的 消息 ,并 按 下 Enter 键 ,随后 服务 器 应 图 11-3 简单 的 UDP 协议 通信 程序 
用 程序 上 会 显示 收 到 的 消息 ,如 图 11-3 所 示 。 


11.2 HTTP 编程 


实例 304 从 Web 服务 器 上 下 载 图 片 


【导语 】 
运行 本 实例 后 ,通过 键盘 输入 Web 服务 器 上 图 片 的 URL, 按 下 Enter 键 后 ,应 用 程序 
会 把 图 片 下 载 到 本 地 并 保存 到 文件 中 。 


T 由 
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本 实例 使 用 了 HttpWebRequest 类 和 HttpWebResponse 类 来 完成 图 片 下 载 ,这 两 个 类 
一 般 是 成 对 使 用 的 。 由 HttpWebRequest 对 象 向 服务 器 发 起 请 求 , 若 服务 器 回应 则 返回 一 
个 HttpWebResponse 对 象 ,通过 HttpWebResponse 对 象 可 以 以 流 的 方式 读 取 来 自 Web 服 
务 器 的 数据 。 如 果 要 将 数据 上 传 到 Web 服务 器 ,应 该 使 用 从 HttpWebRequest 对 象 中 获得 
的 流 对 象 。 总 结 为 一 句 话 就 是 ，HttpWebRequest 对 象 用 于 向 服务 器 写 数据 ， 
HttpWebResponse 对 象 用 于 读 取 来 自 服务 器 的 数据 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 获取 键盘 输入 的 图 片 URL。 

Console. WriteLine(" 请 输入 图 片 的 URL:"); 

string picUrl = Console. ReadLine(); 

步骤 3: 创建 HttpWebRequest 实例 。 该 类 没有 公共 的 构造 函数 ,需要 通过 调用 
WebRequest 的 Create 方法 或 者 CreateHttp 方法 来 获得 HttpWebRequest 实例 的 引用 。 


HttpWebRequest request = WebRequest. CreateHttp(picUr1l) ; 

步骤 4: 设置 访问 方式 为 GET。 

request. Method = "GET"; 

步骤 5: 向 Web 服务 器 发 起 请 求 , 并 获取 HTTP 的 响应 消息 。 
HttpWebResponse response = (HttpWebResponse)request.GetResponse(); 
步骤 6: 读 取 Web 服务 器 响应 的 数据 ,并 写 入 文件 。 


using(Stream respStream = response.GetResponseStream()) 
{ 

// 写 人 文件 

using (FileStream fs = new FileStrean ("down. jpg", 
FileMode. Create)) 

{ 

respStream. CopyTo( fs); 
} 


} 

步骤 7; 运行 应 用 程序 ,输入 图 片 URL, 然后 按 下 图 4 从 Web 服务 器 上 下 载 图 片 
Enter 键 ,图 片 随即 被 下 载 到 本 地 文件 ,如 图 11-4 所 示 。 

实例 305 ”使 用 HttpClient 类 向 Web 服务 器 提交 数据 

【导语 】 


HttpClient 类 对 HTTP 通信 中 的 常用 操作 进行 了 封装 ,为 每 一 种 请 求 定义 了 对 应 的 方 
法 ,具体 方法 如 下 。 
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(1) GetAsync 方 法 : 以 GET 方式 发 送 HTTP 请 求 。 

(2) PostAsync 方 法 : 以 POST 方式 发 送 请 求 。 

(3) PutAsync 方 法 : 以 PUT 方式 发 送 请 求 。 

(4) DeleteAsync 方 法 : 对 应 DELETE 请 求 方式 。 

(5) PatchAsync 方法 : 以 PATCH 方式 发 送 请 求 。 

其 中 ,最 为 常用 的 是 GetAsync 与 PostAsync 两 个 方法 。 此 外 , HttpClient 类 还 提供 了 
SendAsync 方 法 ,此 方法 比较 灵活 ,在 发 送 HTTP 请 求 前 可 以 做 更 多 的 配置 。 

要 提交 的 数据 正文 将 由 HttpContent 类 包装 ,该 类 是 抽象 类 , 需 根据 实际 要 提交 内 容 的 
格式 来 选择 ,例如 ,ByteArrayContent 类 用 于 包装 字 节 数组 ,StringContent 类 用 于 包装 字符 
串 内 容 , 若 希望 以 流 的 形式 提交 数据 ,还 可 以 用 StreamContent 类 。 

本 实例 将 演示 如 何 使 用 HttpClient 类 以 POST 方式 向 Web 服务 器 提交 字符 串 数据 。 

【操作 流程 】 

步骤 1: 创建 HttpClient 实例 。 


using (HttpClient client = new HttpClient()) 
{ 


} 

步骤 2: 包装 要 发 送 的 数据 内 容 。 

StringContent content = new StringContent(" 小 李 "，System. Text. Encoding. UTF8); 

本 例 要 发 送 的 是 字符 串 内 容 , 因 此 选用 StringContent 类 进行 包装 。 

步骤 3: 向 服务 器 发 起 请 求 ,方式 为 HTTP-POST。 

string url = "< 目标 URL>"; 

HttpResponseMessage response = await client.PostAsync(url, content); 

上 述 代码 中 ,请 将 < 目标 URL > 替换 为 实际 的 测试 地 址 。 

步骤 4: 调用 PostAsync 方法 后 ,异步 返回 HttpResponseMessage 对 象 ,表示 服务 器 回 
应 的 消息 ,从 HttpResponseMessage 对 象 的 Content 属性 中 可 以 得 到 服务 器 返回 的 数据 
下 区 : 

string respmsg = await response. Content. ReadAsStringAsync(); 

Console. WriteLine( $ "提交 成 功 ,服务 器 回应 消息 : {respmsg}"); 


注意 : 本 实例 的 源 代码 中 包含 一 个 简单 的 ASP. NET Core 项 目 , 测 试 时 可 以 同时 运行 此 
Web 项 目 。 


反射 与 Composition 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 反射 技术 ; 


。 Composition 。 


12.1 反射 技术 


实例 306 ”获取 程序 集中 的 类 型 列表 


【导语 】 

反射 技术 可 以 在 应 用 程序 运行 阶段 对 程序 集 进行 解析 ,包括 获取 程序 集中 的 类 型 .类 型 
的 成 员 列 表 、 参 数列 表 等 信息 ,还 可 以 创建 类 型 实例 或 调用 类 型 成 员 。 

本 实例 演示 了 如 何 列 出 指定 类 库 中 的 类 型 。 

【操作 流程 】 

步骤 1: 编写 一 个 测试 类 库 , 它 包含 一 个 CoolComponents 命名 空间 ,命名 空间 下 包含 
三 个 自 定义 类 型 。 


namespace CoolComponents 


{ 
public class CoolEngin { } 


public struct FaultData { } 
public class FastBuilder { } 


} 
步骤 2: 生成 类 库 项 目 ,将 输出 的 . dll 文件 复制 到 示例 应 用 程序 的 \bin\Debug\ 


netcoreapp < 版 本 号 > 目录 下 。 
步骤 3: 打开 示例 项 目的 Program. cs 文件 ,引入 以 下 命名 空间 ,与 反射 技术 有 关 的 类 型 


都 位 于 这 个 命名 空间 下 。 


using System. Reflection; 
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步骤 4: 调用 Assembly 类 的 静态 方法 LoadFrom, 从 . dll 文件 中 加 载 程 序 集 。 
Assembly ass = Assembly.LoadFrom("TestLib.dl11"); 


加 载 的 程序 集 以 Assembly 类 表示 ,通过 这 个 类 可 以 获取 类 型 列表 。 
步骤 5: 调用 GetTypes 方法 ,返回 此 程序 集中 所 包含 类 型 ,以 Type 数组 的 形式 返 


加 


Type[ ] types = ass.GetTypes(); 
步骤 6: 在 控制 台中 输出 各 类 型 的 完整 名 称 (包括 命名 空间 和 类 型 的 名 称 ) 和 性 质 ( 引 用 
类 型 或 值 类 型 ) 。 


foreach (TYpe t in types) 
{ 


Console. Write("{0} — ", t.FullName); 
if (t.IsClass) 
Console. Write(" 引 用 类 型 "); 
else if (t. IsValueTYpe) 
Console, Write(" 值 类 型 "); 
else 
Console. Write(" 其 他 类 型 "); 
Console. Write("\n"); 
} 
IsClass 标识 类 型 为 引用 类 型 (类 属于 引用 类 CAProgramFiles\dotnet\dotn., 一 口 X 
型 ) ,结构 是 值 类 型 ,所 以 也 可 以 用 IsValueType olC CoolEngi 2 
属性 来 判断 某 个 类 型 是 否 为 结构 ( 枚 举 是 特殊 的 
值 类 型 ,可 用 IsEnum 属性 来 判断 ) 。 
步骤 7: 运行 应 用 程序 ,输出 结果 如 图 12-1 图 12-1 解析 出 类 库 中 的 类 型 列表 


实例 307 ”获取 指定 类 型 的 成 员 列 表 


【导语 】 

如 果 需 要 获取 指定 类 型 的 所 有 成 员 , 可 以 调用 Type 类 的 GetMembers 方法 。 如 果 需 
要 获取 特定 的 成 员 , 可 以 访问 以 下 方法 : 

(1) 获取 方法 : 调用 GetMethod 或 者 GetMethods 方法 。 

(2) 获取 属性 : 调用 GetProperty 或 者 GetProperties 方法 。 

(3) 获取 事件 : 调用 GetEvent 或 者 GetEvents 方法 。 

(4) 获取 构造 函数 : 调用 GetConstructor 或 者 GetConstructors 方法 。 

(5) 获取 字段 : 调用 GetField 或 者 GetFields 方法 。 

其 中 ,复数 命名 的 方法 用 于 获取 多 个 成 员 对 象 , 例 如 ,GetProperty 方法 可 以 获取 单个 
属性 的 信息 ,而 GetProperties 方法 则 可 以 获取 多 个 属性 的 信息 。 

本 实例 在 获取 类 型 成 员 时 ,不 考虑 成 员 分 类 ,因此 使 用 GetMembers 方法 ; 不 带 参数 的 
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GetMembers 方法 可 获取 指定 类 型 的 公共 成 员 列表 ; 如 果 需 要 获取 非 公共 成 员 , 则 可 以 调 
用 带 有 BindingFlags 枚 举 参数 的 GetMembers 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 以 String 类 为 例 , 获 取 类 型 关联 的 Type 对 象 。 


Type targetType = typeof(string); 

步骤 3: 获取 String 类 的 公共 与 非 公共 成 员 ,实例 与 静态 成 员 。 

MemberInfo[ ] members = targetType. GetMembers(BindingFlags. Instance | BindingFlags. Static | 

BindingFlags. NonPublic | BindingFlags. Public); 

实例 成 员 是 指 需 要 调用 类 型 构造 函数 创建 新 实例 后 才能 访问 的 成 员 ; 静态 成 员 是 指 无 
须 创建 类 型 实例 ,可 以 直接 访问 的 成 员 ,在 声明 静态 成 员 时 会 加 上 static 关键 字 。 

步骤 4: 在 控制 台中 输出 成 员 的 名 称 及 类 别 。 


foreach(MemberInfo mbinfo in members) 


{ 
Console. Write( $ "{mbinfo. MemberType, — 15} : {mbinfo. Name} \n"); 


} 

MemberInfo 类 的 MemberType 属性 是 一 个 MemberTypes 枚 举 ,标识 成 员 的 类 别 。 例 
如 ,对 于 方法 成 员 ,其 枚 举 值 为 Method; 对 于 属性 成 员 ,其 枚 举 值 为 Property。 

步骤 5: 运行 应 用 程序 ,输出 结果 如 图 12-2 所 示 。 


图 12-2 String 类 的 成 员 列 表 
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实例 308 ”获取 方法 的 参数 信息 


【导语 】 

MethodInfo 类 封装 了 常规 方法 (不 包括 构造 函数 ) 的 相关 信息 ,通过 访问 Type 实例 的 
GetMethod 方法 可 以 返回 单个 MethodInfo 实例 。 

要 得 到 方法 的 参数 列表 信息 ,需要 访问 MethodInfo 实例 的 GetParameters 方法 ,调用 
后 会 返回 一 个 ParameterInfo 类 的 数组 。ParameterInfo 类 封装 了 参数 信息 , 其 
ParameterType 属性 表示 参数 的 数据 类 型 ,Name 属性 可 以 获取 参数 名 称 。 如 果 参 数 带 有 
out 关键 字 , 可 以 使 用 IsOut 属性 来 检测 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 Sample 类 ,类 中 包含 一 个 实例 方法 ChangeRate。 


public class Sample 
{ 
public double ChangeRate(uint af, float xf) 
{ 
return default (double); 


} 
T 


稍 后 将 通过 反射 技术 获取 ChangeRate 方法 的 参数 列表 。 
步骤 3: 获取 类 型 相关 的 Type 对 象 。 


Type tp = typeof(Sample); 

步骤 4: 调用 GetMethod 方法 查找 出 ChangeRate 方法 。 

MethodInfo mtinfo = tp.GetMethod(nameof(Sample. ChangeRate) ) ; 

步骤 5: 获取 参数 列表 ,并 输出 参数 信息 (参数 名 与 参数 所 属 的 数据 类 型 ) 。 


if(mtinfo != null) 
{ 
// 获取 参数 列表 
ParameterInfo[ ] prms = mtinfo.GetParameters(); 
Console. WriteLine( $ "{mtinfo. Name} 方法 有 {prms. Length} 个 参数 ,它们 分 别 是 :"); 
foreach(ParameterInfo pi in prms) 
{ 
Console. WriteLine( $" {pi.Name} : {pi.ParameterType}"); 
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步骤 6: 运行 应 用 程序 ,输出 结果 如 图 12-3 所 示 。 


国 cpProgram Flesdometdot， 一 口 


图 12-3 ChangeRate 方法 的 两 个 参数 


实例 309 通过 反射 调用 构造 函数 

【导语 】 

构造 函数 信息 由 ConstructorInfo 类 封装 ,该 类 从 MethodBase 类 派生 (构造 函数 属于 一 
种 特殊 的 方法 )。 可 以 调用 Type 类 实例 的 GetConstructor 或 者 GetConstructors 方法 来 获 
取 与 类 型 构造 函数 有 关 的 ConstructorInfo 实例 。 要 调用 构造 函数 ,需要 访问 Invoke 方法 ， 
Invoke 方法 所 返回 的 就 是 类 型 的 新 实例 (统一 以 object 类 型 返回 ,必要 时 可 以 在 使 用 新 实 
例 前 进行 类 型 转换 ) ,该 方法 需要 一 个 object 数组 作为 输入 参数 , 它 表 示 传 递 给 构造 函数 的 
参数 列表 ; 如 果 构 造 函 数 是 无 参数 的 ,可 以 传递 null。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Pen 类 , 它 包 含 一 个 StrokeWidth 属性 ,一 个 无 参数 的 构造 函数 ,在 该 构造 
函数 中 初始 化 StrokeWidth 属性 。 


T 


namespace Samples 
t 
public class Pen 
{ 
public float StrokeWidth { get; private set; } 


public Pen() 
{ 

StrokeWidth = 1.2f; 
} 


} 

步骤 3: 回 到 Main 方法 中 ,获取 与 Pen 类 相关 的 Type 对 象 。 
Type testType = typeof(Samples.Pen); 

步骤 4: 调用 GetConstructor 方法 获取 构造 函数 引用 。 
onstructorInfo constr = testType. GetConstructor(TYpe. EmptyTypes); 


GetConstructor 方法 需要 提供 构造 函数 的 参数 列表 ,由 于 Pen 的 公共 函数 是 无 参数 的 ， 
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所 以 可 以 直接 使 用 Type 类 中 公开 的 EmptyTypes 字段 , 它 会 返回 一 个 空 的 Type 数组 。 
步骤 5: 调用 构造 函数 ,创建 Pen 类 的 新 实例 ,然后 读 取 StrokeWidth 属性 的 值 。 
ConstructorInfo constr = testType.GetConstructor(Type. EmptyTypes); 


if (constr != null) 
{ 


// 创建 类 实例 


object instance = constr. Invoke(null); 
// 查找 StrokeWidth 属性 
PropertyInfo prop = testType.GetProperty("StrokeWidth"); 
// 获取 属性 值 
object val = prop.GetValue(instance); 
Console. WriteLine("StrokeWidth 属性 的 值 为 :{0}", val); 
} 
使 用 PropertyInfo 类 的 GetValue 方法 可 以 获得 相应 属性 的 值 。 


步骤 6: 运行 应 用 程序 ,输出 结果 如 下 。 
StrokeWidth 属性 的 值 为 :1.2 


实例 310 ”通过 反射 调用 静态 方法 
【导语 】 

MethodInfo 类 的 Invoke 方 法 的 常用 重 载 如 下 。 
object Invoke(object obj，object[ ] parameters); 


如 果 要 调用 的 方法 是 静态 的 (声明 时 使 用 static 关键 字 ) ,那么 在 调用 Invoke 方法 时 
obj 参数 应 为 null, 因 为 访问 静态 成 员 并 不 依赖 类 型 实例 。 

本 实例 将 演示 如 何 运 用 反射 技术 来 调用 带 有 两 个 double 类 型 参数 的 静态 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 定义 一 个 静态 方法 ,名 为 Add, 它 接受 两 个 double 类 型 的 参 
数 , 并 返回 两 个 参数 相 加 的 总 和 。 


public static double Add(double a, double b) =>a + b; 
步骤 3: 在 Main 方法 中 ,获取 与 Add 方法 相关 的 MethodInfo 实例 。 


MethodInfo addMthd = typeof (Program).GetMethod("Add", BindingFlags. Public | BindingFlags. 
Static); 


要 查找 类 型 中 的 静态 成 员 ,BindingFlags 枚 举 需 要 加 上 Static 值 。 
步骤 4: 调用 Add 方法 。 


if(addMthd != null) 
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§ 


// 要 传 给 方法 的 参数 值 列表 
object[] prms = { 3.65d, 17.073d }; 
// 调用 方法 


object returnVal = addMthd. Invoke(null, prms); 
Console. WriteLine( $ "静态 方法 调用 结果 :{returnVal}"); 
} 


步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 
静态 方法 调用 结果 :20. 723 


实例 311 用 Activator 类 创建 类 型 实例 


【导语 】 

除了 通过 ConstructorInfo 来 创建 类 型 实例 外 ,还 可 以 使 用 Activator 类 。 这 是 一 个 静 
态 类 ,因此 它 的 所 有 成 员 方法 都 是 静态 方法 ,该 类 仅 包 含 一 个 方法 一 一 CreateInstance, 用 于 
创建 类 型 实例 ,但 该 方法 有 多 个 重 载 ,最 为 常用 有 以 下 两 个 版 本 : 

(1) 当 要 使 用 类 型 中 带 无 参数 的 构造 函数 时 ,应 调用 以 下 重 载 : 


static object CreateInstance(Type type); 
(2) 当 要 使 用 类 型 中 带 参 数 的 构造 函数 时 ,就 要 调用 以 下 重 载 : 
static object CreateInstance(Type type, params object[] args); 


args 是 传递 给 构造 函数 的 参数 值 列表 ,依照 构造 函数 声明 的 参数 顺序 传 信 即 可 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Person 类 ,该 类 的 构造 函数 需要 三 个 参数 。 


public class Person 
{ 
public Person( string name, string city, int age) 
{ 
Name = name; 
City = city; 
Age = age; 
} 


public string Name { get; } 
public string City { get; } 
public int Age { get; } 
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步骤 3: 获取 Person 类 关联 的 Type 对 象 。 
Type theType = typeof(Person) 


步骤 4: 创建 Person 实例 。 


object instance = Activator.CreateInstance(theType, "Mee Yang", "Zhong Shan", 21); 


由 于 Person 类 的 构造 函数 需要 三 个 参数 ,因此 在 调用 CreateInstance 方法 时 要 传递 相 
应 的 参数 值 。 

步骤 5: 现在 ,Person 类 的 实例 已 经 创建 。 下 面 代 码 将 通过 反射 枚 举 出 Person 对 象 的 
公共 属性 ,然后 输出 各 个 属性 的 值 。 


PropertyInfo[ ] props = theType.GetProperties(BindingFlags. Instance | BindingFlags. Public); 
foreach(PropertyInfo p in props) 
{ 


Console. WriteLine( $ "{p. Name} : {p.GetValue(instance)}"); 
} 
要 一 次 性 获取 多 个 属性 的 信息 ,应 当 调 用 Type 对 象 的 ”图 12-4 输出 Person 对 
GetProperties 方法 。 象 的 公共 属性 
步骤 6: 运行 应 用 程序 ,输出 结果 如 图 12-4 所 示 。 


实例 312 检测 类 型 上 所 应 用 的 自 定义 Attribute 


【导语 】 

CustomAttributeExtensions 类 提供 了 一 系列 扩展 方法 ,可 以 获取 程序 集 、 类 型 .类 型 成 
员 参数 上 应 用 的 自 定义 特性 (Attribute) 实 例 。 

如 果 事 先知 道 特性 的 类 型 , 则 可 以 使 用 带 泛 型 参数 的 方法 : 


T GetCustomAttribute<T>(this …) where T : Attribute; 
此 方法 调用 起 来 是 最 简单 的 ,可 以 直接 返回 目标 特性 的 实例 。 但 是 如 果 使 用 以 下 方法 来 获 
取 自 定义 的 特性 实例 , 则 可 能 需要 进行 类 型 转换 ,因为 它 的 返回 类 型 为 Attribute( 特 性 类 的 
公共 基 类 ) 。 

Attribute GetCustomAttribute(this …，TYpe attributeType); 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 特性 类 , 仅 应 用 于 类 上 面 。 


[AttributeUsage( AttributeTargets. Class, AllowMultiple = false)] 
public sealed class AliasNameAttribute : Attribute 
{ 

public AliasNameAttribute( string aliasName) 
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{ 


Alias = aliasName; 


} 


public string Alias { get; } = null; 


注意 : 特性 类 必须 是 Attribute 的 派生 类 ,或 者 间接 派生 类 。 


12. 


步骤 3: 声明 一 个 测试 类 ,并 在 类 上 应 用 上 述 特性 。 


[AliasName("order_data" ) ] 
public class CoreData 
{ 


} 
步骤 4: 获取 CoreData 上 所 应 用 的 AliasNameAttribute。 


// 获取 与 类 型 相关 的 Type 对 象 
Type testType = typeof(CoreData); 
// 获取 特性 类 实例 
AliasNameAttribute attr = testType.GetCustomAttribute< AliasNameAttribute >(); 
// 输出 特性 类 的 属性 值 
if(attr != null) 
{ 
Console. WriteLine( $ "类 型 {testType. Name} 的 别名 是 :{attr. Alias}"); 
} 


步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 


类 型 CoreData 的 别名 是 :order_data 


2 Composition 


实例 313 ”安装 NuGet 包 一 一 System. Composition 


【导语 】 
Composition 技术 主要 用 于 程序 扩展 , 它 会 根据 协定 标识 主动 发 现 已 导出 的 类 型 ,并 把 


该 类 型 导入 和 组 合 到 特定 实例 上 ,这 样 应 用 程序 代码 就 能 使 用 这 些 导 入 的 类 型 了 。 


默认 情况 下 ,. NET Core 框架 不 包含 Composition 相关 的 API, 开 发 人 员 需 要 通过 


NuGet 手动 安装 System. Composition 包 。 


本 实例 将 演示 在 项 目 中 安装 System. Composition 包 的 过 程 。 
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【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Visual Studio 中 ,从 菜单 栏 中 依次 执行 “工具 ”>“NuGet 包 管 理 器 ”>“ 程 序 
包 管 理 器 控制 台 ” 命 令 。 

步骤 3: 在 “程序 包 管理 器 控制 台 ” 窗 口中 输入 以 下 命令 ,然后 按 Enter 键 执行 。 

Install — Package System. Composition 

步骤 4: 等 待 安装 完成 。 

步骤 5: 程序 包 安 装 完毕 后 ,在 “解决 方案 资源 管理 器 * 窗 口中 ,展开 项 目下 的 “依赖 项 ” 
结 点 ,可 以 看 到 安装 好 的 程序 包 以 及 它 所 依赖 的 其 他 程序 包 , 如 图 12-5 所 示 。 


图 12-5 System. Composition 以 及 其 依赖 项 


注意 : 程序 包 安 装 是 基于 项 目的 ,因此 在 新 建 的 项 目 中 如 果 需 要 用 到 System. Composition 
组 件 , 需 要 手动 安装 。 


实例 314 ”导出 类 型 


【导语 】 

在 要 作为 扩展 组 件 的 类 上 应 用 ExportAttribute 后 ,该 类 便 被 标识 为 可 导出 类 型 , 即 它 
可 以 被 Composition 引擎 发 现 。ExportAttribute 类 有 两 个 很 重要 的 属性 : 

(1) ContractName 属性 : 类 型 协定 的 名 称 。 开 发 人 员 可 以 自 定义 该 名 称 ,必须 要 保证 
该 名 称 在 所 有 导出 类 型 中 的 唯一 性 ,否则 协定 名 称 就 失去 实际 用 途 了 (就 是 用 来 标识 类 型 协 
定 的 ) 。 

(2) ContractType 属性 : 协定 的 类 型 。 如 果 不 指 定 该 属性 ,默认 的 类 型 是 跟随 在 
ExportAttribute 之 后 的 类 型 ( 即 该 特性 所 应 用 的 目标 类 ) 。 

为 了 让 扩展 的 组 件 具有 规律 性 (存在 相似 特征 ) ,以 便于 在 运行 时 灵活 使 用 ,通常 会 为 所 
有 待 导 出 的 类 定义 一 个 共同 的 接口 ,然后 这 些 类 都 实现 这 个 接口 。 这 样 对 于 类 型 的 导入 者 

言 , 只 需要 认 准 这 个 通用 的 接口 ,而 不 必 考 虑 具体 的 实现 类 ,可 以 轻松 导入 并 调用 多 个 

类 型 。 
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【操作 流程 】 
为 了 使 演示 的 内 容 更 易于 理解 ,本 例 中 所 定义 的 导出 类 型 都 与 应 用 程序 在 同一 个 程序 
集中 。 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 两 个 类 一 一 Car 和 Bike, 它 们 都 应 用 了 ExportAttribute。 


[Export] 
public class Car 
{ 
public string Identity => "小 汽车 "; 
} 


[Export] 

public class Bike 

{ 

public string Identity => "自行 车 "; 

} 

应 用 ExportAttribute 时 , 既 没有 指定 协定 的 名 称 , 也 没有 指定 协定 的 类 型 ,所 以 获取 导 
出 类 型 实例 时 ,所 指定 的 筛选 类 型 应 与 Car 类 或 Bike 类 相同 。 

步骤 3: 查找 导出 的 类 型 ,并 获取 它们 的 实例 ,最 后 分 别 访问 它们 的 Identity 属性 。 


ContainerConfiguration config = new ContainerConfiguration(); 
// 在 当前 程序 集中 查找 类 型 
config. WithAssembly( Assembly. GetExecutingAssembly()); 
// 创建 容器 
using(CompositionHost host = config.CreateContainer()) 
{ 
// 获取 已 导出 的 类 型 实例 
Car c = host. GetExport< Car >(); 
Bike b = host.GetExport < Bike>(); 
Console. WriteLine( $ "c. Identity : {c. Identity}\nb. Identity : {b. Identity}"); 
} 


首先 要 创建 ContainerConfiguration 实例 ,对 Composition 操作 进行 配置 。 在 上 述 代码 
中 ,WithAssembly 方法 用 于 指定 查找 导出 类 型 的 程序 集 , 本 例 为 当前 程序 集 。 然 后 调用 
CreateContainer 方法 创建 用 于 获取 导出 类 型 实例 的 CompositionHost 对 象 。 再 通过 
GetExport 方法 就 可 以 获取 导出 类 型 的 实例 。 导 出 类 型 在 实例 化 时 ,Composition 组 件 会 调 
用 它 的 公共 无 参数 构造 函数 ,所 以 要 导出 的 类 中 必须 包含 无 参数 的 公共 构造 器 。 

步骤 4: 运行 应 用 程序 ,输出 内 容 如 下 。 


c.Identity : 小 汽车 
b. Identity : 自行 车 
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注意 : 本 实例 的 导出 类 型 在 设计 上 并 不 合理 ,只 是 为 了 演示 。 推 荐 的 做 法 是 定义 一 个 接口 ， 
并 在 接口 中 公开 Identity 属性 ,然后 Car 和 Bike 类 都 实现 这 个 接口 。 这 样 在 获取 导 
出 类 型 时 ,只 需要 提供 该 接口 作为 查找 条 件 即 可 。 


实例 315 ”通过 协定 来 约束 导出 类 型 


【导语 】 

本 实例 将 演示 通过 指定 唯一 命名 与 类 型 协定 来 标识 导出 类 型 ,这 样 做 既 能 保证 导出 的 
类 型 具有 了 唯一 的 标识 ,又 可 以 保持 兼容 性 。 本 例 中 所 有 导出 的 类 都 会 实现 IPlayer 接口 。 
尽管 被 导出 的 类 型 都 被 约束 为 IPlayer, 但 每 一 个 导出 的 类 型 都 设置 了 协定 名 称 ( 确 保 不 会 
重复 出 现 ) 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 安装 System. Composition NuGet 包 。 

步骤 3: 引入 以 下 命名 空间 。 


using System; 

using System. Composition; 

using System. Composition. Hosting; 
using System. Reflection; 


步骤 4: 声明 IPlayer 接口 ,作为 导出 类 型 的 公共 规范 。 


public interface IPlayer 
{ 

void PlayTracks( ); 
} 


步骤 $: 定义 两 个 实现 IPlayer 接口 的 类 .并 且 应 用 ExportAttribute。 


[Export("gen_pl", typeof(IPlayer))] 
public class GenPlayer : IPlayer 
1 public void PlayTracks() 
Console. WriteLine(" 在 普通 播放 器 上 播放 音乐 "); 
} 


[Export("pro_pl", typeof(IPlayer))] 
public class ProPlayer : IPlayer 
{ 

public void PlayTracks() 
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Console. WriteLine(" 在 专业 播放 器 上 播放 音乐 "); 


| 
步骤 6: 回 到 Main 方法 中 ,获取 当前 正在 执行 的 程序 集 。 
Assembly currAss = Assembly.GetExecutingAssembly(); 


步骤 7: 创建 ContainerConfiguration 实例 ,设置 导出 类 型 的 查找 范围 位 于 当前 程序 
集中 。 


ContainerConfiguration config = new ContainerConfiguration( ) 
.WithAssembly(currAss); 


步骤 8: 创建 Composition 容器 ,并 获取 导出 类 型 的 实例 。 


using(CompositionHost host = config. CreateContainer() ) 
host. GetExport < IPlayer >("gen_p1"); 
host. GetExport < IPlayer >("pro_p1"); 


IPlayer pl 


IPlayer p2 
} 
在 调用 GetExport 方法 时 ,需要 传递 每 个 导出 类 型 所 对 应 的 协定 名 称 。 
步骤 9: 分 别 调用 两 个 对 象 实例 的 PlayTracks 方法 。 


using(CompositionHost host = config.CreateContainer()) 
{ 


pl.PlayTracks(); 
p2. PlayTracks(); 
} 


步骤 10: 运行 应 用 程序 ,会 看 到 以 下 输出 结果 。 


在 普通 播放 器 上 播放 音乐 
在 专业 播放 器 上 播放 音乐 


实例 316 导入 多 个 类 型 


【导语 】 

Composition 技术 支持 将 类 型 导入 到 某 个 类 的 属性 (或 方法 参数 ) 中 。 应 用 了 
ImportAttribute 的 属性 只 可 以 导入 单个 类 型 实例 ,而 应 用 了 ImportManyAttribute 的 属性 
则 可 以 导入 多 个 类 型 实例 ,此 时 属性 一 般 声明 为 [Enumerable < T > 类 型 ,Composition 容器 
在 导入 类 型 时 会 自动 填充 该 属性 。 

本 实例 中 ,以 IAnimal 接口 作为 类 型 协定 的 基础 ,有 三 个 类 实现 该 接口 ,并 标记 为 导出 
类 型 。 然 后 定义 SomeAnimalSamples 类 ,并 公开 AnimalList 属性 ,其 类 型 为 IEnumerable 
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<IAnimal >。 最 后 用 Composition 容器 将 导入 的 类 型 实例 填充 AnimalList 集合 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 IAnimal 接口 ,公开 两 个 属性 。 


public interface IAnimal 
string Name { get; } 
string Family { get; } 


步骤 3: 定义 三 个 实现 IAnimal 接口 的 类 ,并 标识 为 导出 类 型 。 


Export( typeof (IAnimal))] 
public class FelisCatus : IAnimal 


public string Name => "家 猫 "; 
public string Family => " 猫 科 "; 
Export (typeof (IAnimal))] 


public class SolenopsisInvictaBuren : IAnimal 


public string Name => "红火 蚁 "; 
public string Family => " 蚁 科 "; 


Export( typeof (IAnimal))] 
public class HeliconiusMelpomene : IAnimal 
{ 
public string Name => " 红 带 袖 蝶 "; 
public string Family => " 凤 蝶 科 "; 


步骤 4: 定义 SomeAnimalSamples 类 ,并 把 AnimalList 标记 为 可 导入 多 个 类 型 。 


class SomeAnimalSamples 


{ 
[ImportMany] 
public IEnumerable < IAnimal > AnimalList { get; set; } 


注意 : 记得 要 在 属性 上 应 用 ImportManyAttribute, 因 为 Composition 在 组 合 类 型 时 会 查找 
该 特性 。 
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步骤 5: 回 到 Main 方法 ,将 当前 程序 集 作为 Composition 搜索 导出 类 型 的 范围 。 


Assembly currentAssembly = Assembly.GetExecutingAssembly(); 
ContainerConfiguration config = new ContainerConfiguration() 
.WithAssembly(currentAssembly); 
步骤 6: 创建 Composition 容器 ,并 将 导入 的 类 型 组 合 到 SomeAnimalSamples 对 象 的 
AnimalList 属性 中 。 
SomeAnimalSamples samples = new SomeAnimalSamples(); 
using(CompositionHost container = config.CreateContainer()) 


{ 


container. SatisfyImports( samples); 


} 
步骤 7: 测试 访问 导入 的 类 型 实例 。 


foreach (IAnimal an in samples. AnimalList) 


{ 
Console. WriteLine( $ "Name: {an. Name}\nFamily: {an. Family}\n"); 


上 图 12-6 访问 导入 后 的 
步骤 8: 运行 应 用 程序 ,得 到 如 图 12-6 所 示 的 结果 。 Bn 


实例 317 “导出 元 数据 


【导语 】 

在 导出 类 型 的 时 候 , 可 以 同时 将 元 数据 导出 。 元 数据 可 以 理解 为 一 系列 附加 信息 ,这 些 
数据 与 类 型 相关 但 不 参与 执行 ,仅仅 对 类 型 做 出 额外 的 描述 。 在 要 导出 的 类 型 上 应 用 
ExportMetadataAttribute 可 以 添加 要 导出 的 元 数据 , 它 包 含 两 个 值 : Name 是 元 数据 字段 
的 名 称 , 类 型 为 字符 串 ; Value 是 与 字段 对 应 的 值 ,类 型 为 object, 即 每 条 元 数据 的 结构 类 似 
于 字典 。 要 指定 多 条 元 数据 ,可 以 在 导出 的 类 型 上 应 用 多 个 ExportMetadataAttribute。 

在 导入 时 ,可 以 使 用 Lazy< 工 , TMetadata > 类 型 的 对 象 来 接收 导入 的 类 型 与 元 数据 。 
Lazy 类 提供 了 一 种 机 制 一 一 类 型 可 以 延迟 初始 化 , 即 当 Value 属性 被 访问 时 才 会 调用 工 类 
型 的 构造 器 。TMetadata 表示 导入 的 元 数据 ,一 般 情 况 下 ,可 以 使 用 IDictionary < string， 
object > 类 型 来 接收 元 数据 ,也 可 以 使 用 一 个 自 定义 的 类 来 接收 ( 带 无 参数 构造 函数 的 类 )。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 要 导出 的 类 型 ,并 指定 两 条 元 数据 记录 。 


[Export] 

[ExportMetadata( "Ver", "1.0")] 
[ExportMetadata( "Publisher", "Mike")] 
public class Test 


第 12 章 ”反射 与 Composition | 401 


public void Run() 
{ 
Console. WriteLine("Run 方法 被 调用 "); 
} 
} 


步骤 3: 在 Program 类 中 ,声明 一 个 属性 ,用 于 接收 导入 的 类 型 。 


[Import] 
Lazy < Test, IDictionary< string, object > 之 ComposObject { get; set; } 


步骤 4: 创建 Composition 容器 ,然后 合并 导入 的 类 型 。 


ContainerConfiguration cfg = new ContainerConfiguration ( ). WithAssembly ( Assembly. 
GetExecutingAssembly( )); 
Program p = new Program(); 
using(CompositionHost container = cfg. CreateContainer()) 
container. SatisfyImports(p); 
} 


步骤 5: 访问 已 导入 的 Test 实例 。 


Test t = p.ComposObject. Value; 
// 调用 导入 的 实例 
t. Run(); 
E 有 有 元 
步骤 6: 获取 导入 的 元 数据 。 pr 
去 被 调用 


IDictionary < string, object > metas = p. ComposObject. 
Metadata; 
foreach( KeyValuePair < string, object > kv in metas) 
{ 

Console. WriteLine ( $ " key: {kv. Key}, value: {kyv. 
Value}"); 


} 
步骤 7: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 12-7 所 示 。 


实例 318 ”使 用 自 定义 类 型 来 接收 时 入 的 元 数据 


【导语 】 

导入 的 元 数据 ,不仅 可 以 使 用 IDictionary < string，object > 类 型 来 接收 ,还 可 以 使 用 自 
定义 的 类 来 接收 ,此 自 定义 类 需要 满足 两 个 条 件 : 

(1) 包含 公共 的 无 参数 构造 函数 。 因 为 在 填充 元 数据 时 ,类 实例 由 Composition 自动 
创建 ,而 不 是 从 代码 中 显 式 调用 构造 函数 。 

(2) 该 类 中 的 属性 名 称 必须 与 导出 的 元 数据 的 Name 属性 匹配 ,而 且 是 区 分 大 小 写 的 。 


图 12-7 输出 导入 的 元 数据 
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【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 。 
步骤 2: 声明 要 导出 的 类 型 ,并 附加 元 数据 。 


[Export] 

[ExportMetadata( "MaxTracks", 15), 
ExportMetadata( "Skin", "blue")] 

public class FunMusicPlayer 


{ 
public void Play() => Console. WriteLine(" 正 在 播放 音乐 … …"); 
上 


步骤 3: 定义 一 个 类 ,用 于 在 导入 时 存储 元 数据 。 


class ImportMetaData 


{ 
public int MaxTracks { get; set; } 
public string Skin { get; set; } 

» 


在 导出 类 型 时 ,指定 的 元 数据 名 称 分 别 为 MaxTracks 和 Skin, 所 以 ImportMetaData 类 
的 属性 名 称 必须 与 之 一 一 对 应 。 
步骤 4: 在 Program 类 中 公开 一 个 属性 ,用 于 引用 导入 的 类 型 。 


[Import] 
public Lazy < FunMusicPlayer, ImportMetaData> CurPlayer { get; set; } 


步骤 5: 实例 化 Composition 容器 ,执行 导入 操作 。 


ContainerConfiguration cfg = new ContainerConfiguration ( ). WithAssembly ( Assembly. 
GetExecutingAssembly( )); 
Program p = new Program(); 
using(CompositionHost host = cfg.CreateContainer()) 
L 
host. SatisfyImports(p); 
} 


步骤 6: 输出 已 导入 的 元 数据 。 


ImportMetaData meta = p.CurPlayer.Metadata; 
Console. WriteLine( $ "{nameof ( ImportMetaData. MaxTracks)}: 
{meta. MaxTracks} \n{nameof ( ImportMetaData. Skin)}: {meta. Skin}"); 


步骤 7: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 


MaxTracks: 15 
Skin: blue 
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实例 319 封装 元 数据 

【导语 】 

若 元 数据 的 条 目 比较 多 ,使 用 多 个 ExportMetadataAttribute 对 象 来 指定 元 数据 会 显得 
比较 麻烦 。 这 时 候 可 以 用 一 个 类 来 封装 元 数据 ,但 要 注意 以 下 两 点 : 

(1) 封装 元 数据 的 类 需要 应 用 MetadataAttributeAttribute 进行 标注 。 

(2) 这 个 封装 类 应 当 从 Attribute 类 派生 。 因 为 导出 类 型 的 元 数据 是 附加 信息 ,以 特性 
的 形式 应 用 到 导出 类 型 的 定义 上 。 

【操作 流程 】 

步骤 1: 定义 协定 接口 。 

public interface ITest 


void RunTask( ); 
} 


步骤 2: 定义 元 数据 的 封装 类 。 


[MetadataAttribute] 

class CustMetadataAttribute : Attribute 

{ 
public string Author { get; set; } 
public string Description { get; set; } 
public int Version { get; set; } 


public CustMetadataRttribute( string author, string desc, int ver) 
{ 

Author = author; 

Description = desc; 

Version = ver; 


步骤 3: 定义 两 个 用 于 导出 的 类 ,它们 都 实现 ITest 接口 ,并 且 应 用 定义 好 的 
CustMetadataAttribute 来 指定 元 数据 。 


区 


Export( typeof(ITest))] 
CustMetadata("Tom", "debug version", 1)] 
public class TestWork V1 : ITest 


public void RunTask( ) 
1 

Console. WriteLine(" 这 是 版 本 1"); 
} 
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Export(typeof (ITest))] 
CustMetadata( "Jack", "release version", 2)] 
public class TestWork V2 : ITest 


public void RunTask( ) 


{ 
Console. WriteLine(" 这 是 版 本 2"); 


} 
步骤 4: 定义 一 个 新 类 ,用 于 引用 导入 的 类 型 与 元 数据 。 


public class TestCompos 


[ImportMany] 
public IEnumerable < Lazy < ITest, IDictionary < string, object >>> ImportedComponents { 
get; set; } 


步骤 5: 加 载 要 查找 导出 类 型 的 程序 集 。 


Assembly comAss = Assembly.LoadFrom("CustExportProj. dl11"); 
ContainerConfiguration config = new ContainerConfiguration().WithAssembly(comAss); 


步骤 6: 创建 Composition 容器 ,并 把 类 型 导入 到 刚 定义 的 TestCompos 实例 中 。 


TestCompos cps = new TestCompos(); 
using (var host = config.CreateContainer()) 


{ 
host. SatisfyImports(cps); 
} 


步骤 7: 获取 导入 的 元 数据 ,然后 调用 导入 的 类 型 。 


foreach (var c in cps. ImportedComponents) 
{ 
ITest obj = c.Value; 
IDictionary < string, object > meta = c.Metadata; 
Console. Write(" 元 数据 :\n"); 
foreach(var it in meta) 
{ 
Console. Write( $ "{it. Key}: {it. Value}\n"); 
} 
Console. Write( $ "调用 {obj. GetType() .Name} 实例 :\n"); 
obj. RunTask( ); 
Console. Write("\n\n"); 
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步骤 8: 运行 应 用 程序 ,输出 结果 如 图 12-8 所 示 。 


图 12-8 输出 元 数据 与 导入 对 象 的 调用 结果 


实例 320 用 抽象 类 来 充当 协定 类 型 

【导语 】 

Composition 不 仅 支持 以 接口 作为 协定 类 型 ,还 可 以 使 用 抽象 类 。 接 口 和 抽象 类 都 具 
有 规范 类 型 结构 的 作用 。 

【操作 流程 

步 又 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 抽象 类 ,作为 导出 类 型 的 公共 基 类 。 


public abstract class GenBase 


public abstract Guid ID { get; } 
public abstract string Title { get; } 
public abstract void ConnectEndpoint( ); 


步骤 3: 定义 两 个 导出 类 型 ,它们 都 实现 GenBase 抽象 类 。 


Export( typeof (GenBase))] 
public class CompoFirst : GenBase 


public override Guid ID => Guid. NewGuid( ); 
public override string Title => "test component I"; 
public override void ConnectEndpoint() 
{ 
Console. WriteLine("Connecting to DWO DB …"); 


} 
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[Export(typeof (GenBase))] 
public class CompoSecond : GenBase 
{ 
public override Guid ID => Guid. NewGuid( ); 
public override string Title => "test component II"; 
public override void ConnectEndpoint( ) 
{ 


Console. WriteLine( "Connecting to RLS DB .…"); 


} 
步骤 4: 配置 ContainerConfiguration 实例 。 


Assembly curAssembly = Assembly.GetExecutingAssembly(); 
ContainerConfiguration config = new ContainerConfiguration(); 
config. WithAssembly(curAssembly); 


步骤 5: 创建 Composition 容器 ,并 调用 导出 的 类 型 实例 。 


using(var host = config.CreateContainer()) 


{ 
IEnumerable < GenBase > objs = host. GetExports < GenBase>(); 


foreach (GenBase o in objs) 
{ 
Console. Write("ID: {0}\nTitle: {1}\n", o.1D, o.Title); 
Console. WriteLine(" 调 用 {0} 的 {1} 方法 :"，o. GetType(). Name, nameof 
(GenBase. ConnectEndpoint)); 
0.ConnectEndpoint(); 
Console. Write("\n"); 


} 
步骤 6: 运行 应 用 程序 ,输出 结果 如 图 12-9 所 示 。 


图 12-9 以 抽象 类 来 充当 协定 类 型 


加 密 算 法 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 单 向 加 密 ; 
。 双向 加 密 。 


13.1 单 向 加 密 


实例 321 计算 输入 字符 串 的 MDSs 值 


【导语 】 

在 哈 希 算法 中 ,MD5 是 最 为 常见 的 ,多 用 于 校 验 密码 ,一般 的 做 法 是 , 先 用 密码 字符 串 
计算 出 其 MD5 值 ,再 把 该 MD5 值 转换 为 字符 串 , 存 进 数 据 库 。 校 验 时 重新 计算 输入 密码 
的 MD5 值 ,再 与 数据 库 中 存储 的 值 做 比较 ,如 果 相 同 则 表示 密码 正确 。 

本 实例 将 对 输入 的 文本 进行 MD5 计算 ,然后 输出 计算 得 到 的 哈 希 码 。 

【操作 流程 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 获取 用 户 的 键盘 输入 内 容 。 


Console. WriteLine(" 请 输入 文本 :"); 
string input = Console. ReadLine(); 


步骤 3: 计算 输入 内 容 的 MD5 值 。 


byte[ ] data = Encoding. UTF8.GetBytes( input); 
MD5 md5 = MD5.Create(); 
byte[ ] result = md5.ComputeHash(data); 


注意 : 加 密 算法 都 是 针对 字 节 进行 计算 的 ,因此 在 计算 之 前 ,要 把 计算 内 容 转换 为 字 节 
数组 。 
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步骤 4: 输出 计算 结果 。 


Console. WriteLine("\n 计算 结果 :"); 
foreach(byte b in result) 
{ 

Console. Write(" Ox{0:x2}", b); 
} 


步骤 5: 运行 应 用 程序 ,结果 如 图 13-1 所 示 。 


实例 322 ”使 用 SHA1 算法 校 验 文件 


【导语 】 

对 于 数量 不 是 很 大 的 情况 ,例如 一 般 文 件 , 可 以 使 用 SHA1 算法 校 验 。 校 验 可 以 用 在 
两 种 情况 中 : 一 是 通过 网 络 传输 文件 后 ,为 了 检查 下 载 的 文件 是 否 出 现 数据 损失 ,可 以 将 源 
文件 的 哈 希 码 与 下 载 后 文件 的 哈 希 码 作 比较 ,如 果 两 个 文件 的 哈 希 码 相同 ,表明 文件 已 经 正 
确 传输 ; 另 一 种 情况 是 可 以 通过 哈 希 码 来 检查 两 个 文件 的 内 容 是 否 相同 (可 用 于 查找 重复 
交 件 5 

本 实例 将 首先 创建 一 个 文件 , 写 和 人 随机 字 节 流 , 然 后 将 文件 进行 复制 ,最 后 用 SHA1 算 
法 分 别 计算 两 个 文件 的 哈 希 码 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 新 文件 , 写 入 随机 字 节 。 


图 13-1 输入 文本 的 MD5 值 


using(FileStream fsin = File.Create("verl. smp")) 
{ 
byte[ ] buffer = new byte[256]; 
Random rand = new Random(); 
for(int x = 0; x<50; x++) 
{ 
rand. NextBytes(buffer); 
fsin. Write(buffer); 


} 

步骤 3: 复制 刚 创 建 的 文件 。 

File.Copy("verl. smp", "ver2. smp", true); 

步骤 4: 使 用 SHAIL 算法 ,分 别 计算 这 些 文件 的 喻 希 码 。 


string curdir = Directory. GetCurrentDirectory(); 
string[ ] files = Directory.GetFiles(curdir, " * .smp"); 
SHA1 sha = SHA1.Create(); 

foreach (string f in files) 
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using(FileStream fs = File.OpenRead(f)) 
{ 
byte[ ] result = sha.ComputeHash(fs); 
Console. WriteLine( "文件 {0} 的 哈 希 码 :"，Path. GetFileName(f)); 
StringBuilder bd = new StringBuilder(); 
foreach(byte b in result) 
t 
bd. AppendFormat("{0:X2}", b); 
} 
Console. Write(bd + "\n\n"); 


} 

kb 

sha. Dispose(); 

ComputeHash 方法 有 多 个 重 载 , 既 可 以 传 
入 字 节 数组 进行 计算 ,也 可 以 直接 使 用 流 对 象 。 
该 算法 的 计算 结果 是 以 字 节 序列 表示 的 ,上 述 代 
码 将 计算 结果 转换 为 十 六 进 制 形式 的 字符 串 。 

步骤 5: 运行 应 用 程序 ,从 输出 结果 可 以 看 
到 ,复制 后 的 文件 与 原来 的 文件 相同 ,因为 它们 
具有 相同 的 哈 希 码 , 如 图 13-2 所 示 。 


13.2 双向 加 密 


实例 323 使 用 AES 算法 加 密 和 解密 文本 


【导语 】 

AES 属于 双向 加 密 算 法 ( 即 数据 被 加 密 后 可 以 解密 ) ,通常 需要 两 个 重要 元 素 : 密 钥 
(Key) 和 初始 向 量 (IV) ,必须 提供 与 加 密 相 同 的 Key 和 IV 才能 顺利 完成 解密 。 双 向 加 密 
算法 需要 CryptoStream 类 作为 数据 内 容 的 读 写 中 介 ,CryptoStream 对 象 并 不 表示 特定 的 
流 实例 ,因此 它 需要 基础 流 ( 例 如 内 存 流 文件 流 等 ) 。 

本 实例 演示 了 使 用 AES 算法 加 密 文 本 内 容 ,然后 对 加 密 后 的 数据 进行 解密 ,还 原文 本 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 EncryptData 方法 ,接收 密 钥 、 初 始 向 量 和 竺 加密 的 文本 ,并 返回 加 密 后 的 
字 节 数组 。 


图 13-2 相同 的 文件 产生 相同 的 哈 希 码 


static byte[ ] EncryptData(byte[ ] key, byte[ ] iv, string content) 
{ 
byte[ ] res = null; 
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using(Aes aes = Res.Create()) 
. 
using(MemoryStream msbase = new MemoryStream()) 
和 
using(CryptoStream cstr = new CryptoStream(msbase, aes.CreateEncryptor(key, iv), 
CryptoStreamMode. Write)) 
人 
using(StreamWriter writer = new StreamWriter(cstr)) 
{ 
writer. Write(content); 
} 
» 
res = msbase. ToArray(); 
} 
} 
return res; 


} 


在 实例 化 CryptoStream 类 时 ,CryptoStreamMode 的 取 值 是 很 关键 的 。 上 述 方法 中 , 待 
加 密 的 数据 是 通过 CryptoStream 实例 写 入 的 ,最 终 把 加 密 后 的 数据 写 到 内 存 流 中 ,所 以 此 
处 mode 参数 应 使 用 Write 值 。 


步骤 3: 定义 DecryptData 方法 ,进行 解密 操作 ,还 原 字符 串 。 


static string DecryptData(byte[ ] key，byte[ ] iv, byte[ ] dataContent) 
{ 
string res = null; 
using(Res aes = Res.Create()) 
{ 
using(MemoryStream ms = new MemoryStream(dataContent)) 
{ 
ICryptoTransform trf = aes.CreateDecryptor(key, iv); 
using(CryptoStream cstream = new CryptoStream(ms, trf, CryptoStreamMode. Read)) 
using(StreamReader reader = new StreamReader(cstream)) 
{ 
res = reader.ReadToEnd(); 
} 


} 
} 


return res; 


} 


上 述 代 码 中 ,用 已 加 密 的 字 节 数组 创建 了 内 存 流 ,CryptoStream 实例 以 内 存 流 为 基础 ， 
先 从 内 存 流 中 读 入 已 加 密 的 数据 ,然后 进行 解密 计算 ,最 后 传 到 StreamReader 对 象 中 被 读 
出 来 。 因 此 在 实例 化 CryptoStream 类 时 ,mode 参数 应 该 取 Read 值 。 
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步骤 4: 回 到 Main 方法 中 ,声明 相关 的 变量 。 


// 待 加 密 的 内 容 

string msgToEnc = "实验 文本 "; 
// 加 密 用 的 密 钥 

byte[ ] key; 

// 初始 向 量 

byte[ ] iv; 


步骤 5; 在 本 例 中 ,分 别 调用 Aes 类 的 GenerateKey 方法 和 GeneratelV 方法 ,将 随机 产 
生 key( 密 钥 ) 和 iv( 初 始 向 量 ) 。 


using(Res aes = Rhes.Create()) 
{ 

aes. GenerateKey( ); 

key = aes. Key; 

aes. GeneratelIV( ); 

iv = aes.IV; 


步骤 6: 下 面 代码 对 文本 进行 加 密 。 


byte[ ] encData = EncryptData(key, iv, msgToEnc); 

Console. WriteLine(" 原 文本 :{0}"，msgToEnc) ; 

Console. WriteLine (" 加密 后 : {0}"，BitConverter. ToString 
(encData) ) ; 


步骤 7: 接 下 来 进行 解密 ,恢复 文本 信息 。 


图 13-3 用 AES 算法 加 
密 和 解密 文本 


string decMsg = DecryptData(key, iv, encData); 
Console. WriteLine(" 解 密 后 :{0}"，decMsg); 


步骤 8: 运行 应 用 程序 ,效果 如 图 13-3 所 示 。 
实例 324 不 需要 初始 向 量 的 AES 加 密 


【导语 】 

双向 加 密 ( 对 称 加 密 ) 的 基 类 (SymmetricAlgorithm 类 ) 公 开 了 一 个 Mode 属性 ,类 型 为 
CipherMode 枚 举 ,默认 取 值 为 CBC。 由 于 AES 算法 是 SymmetricAlgorithm 的 子 类 ,所 以 
在 加 密 与 解密 时 都 需要 提供 匹配 的 密 钥 与 初始 向 量 。 若 将 Mode 属性 改 为 ECB, 在 加 /解密 
时 则 可 以 忽略 初始 向 量 , 仅 使 用 密 钥 即 可 ,但 是 ECB 模式 存在 一 定 的 安全 隐患 ,建议 用 于 加 
密 一 些 简单 的 .不 太 重 要 的 文本 信息 。 

本 实例 将 使 用 ECB 模式 的 AES 算法 来 加 密 与 解密 通过 键盘 输入 的 文本 内 容 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 GenerateKey 方法 ,用 于 生成 随机 密 钥 (Key) 。 
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static byte[ ] GenerateKey() 

{ 
byte[ ] theKey = null; 
using(Aes aes = Res.Create()) 


{ 


aes. GenerateKey( ); 
theKey = aes. Key; 
} 
return theKey; 
} 


步骤 3: 定义 EncryptoText 方法 对 输入 的 文本 进行 加 密 , 并 返回 加 密 后 的 字 节 数组 。 


static byte[ ] EncryptoText(byte[ ] key, string text) 
byte[ ] resData = null; 
using(Res aescrpt = Aes.Create()) 
{ 
aescrpt. Mode = CipherMode. ECB; 
using(MemoryStream mmrStr = new MemoryStream()) 
t 
ICryptoTransform cf = aescrpt.CreateEncryptor(key, null); 
using(CryptoStream cs = new CryptoStream(mmrStr, cf, CryptoStreamMode. Write)) 
4 
using(StreamWriter writer = new StreamWriter(cs)) 
{ 


writer. Write( text); 


» 
resData = mmrStr.ToArray(); 


， 


return resData; 


} 
步骤 4: 定义 DecryptoText 方法 ,解密 已 


:加 密 的 文本 。 


static string DecryptoText(byte[ ] key, byte[ ] data) 
{ 
string _text = null; 
using(Res aescrypt = Res.Create()) 
{ 
aescrypt. Mode = CipherMode. ECB; 
using(MemoryStream mmstream = new MemoryStream(data) ) 
ICryptoTransform cf = aescrypt.CreateDecryptor(key, null); 
using(CryptoStream cs = new CryptoStream(mmstream, cf, CryptoStreamMode. Read)) 
{ 


第 13 章 ”加 密 算法 | 了 413 


using(StreamReader reader = new StreamReader(cs)) 
{ 
_text = reader. ReadToEnd(); 


} 


} 
} 


return text; 


注意 : 在 解密 时 ,创建 Aes 实例 后 ,要 设置 其 Mode 属性 为 ECB, 使 其 与 加 密 时 的 模式 匹配 ， 


否则 无 法 正常 解密 。 
步骤 5: 运行 应 用 程序 ,控制 台 输 出 内 容 如 图 13-4 所 示 。 


图 13-4 基于 ECB 模式 的 加 密 


实例 325 用 RSA 算法 加 密 和 解密 数据 

【导语 】 

RSA 算法 也 需要 密 钥 (Key) 来 加 密 和 解密 数据 ,但 是 该 算法 使 用 的 是 两 个 密 钥 一 一 公 
钥 与 私 钥 。 公 钥 用 于 加 密 数据 ,但 不 能 解密 数据 ,因此 公 钥 可 以 对 外 公开 (例如 可 以 通过 网 
络 传输 给 他 人 使 用 ); 而 私 钥 是 不 能 公开 的 ,加 密 后 的 数据 需要 用 私 钥 解密 。 

RSA 算法 可 以 用 来 对 网 络 数据 进行 保护 ,毕竟 以 明文 传输 数据 很 容易 被 他 人 截获 而 千 
成 信息 泄露 。 例 如 ,A 与 B 进行 通信 ,A 可 以 将 自己 的 公 钥 告诉 B, 同 样 B 也 可 以 将 自己 的 
公 钥 告诉 A, 但 私 钥 由 A.B 各 自 保密 ,不 能 公开 。 对 话 的 时 候 ,A 使 用 B 的 公 钥 对 消息 加 
密 ,然后 发 送 给 B,B 收 到 消息 后 用 自己 的 私 钥 解密 ,就 能 看 到 消息 内 容 了 ， 同 理 ,如 果 马 要 
向 A 发 送 消息 ,就 要 用 A 的 公 钥 将 消息 加 密 然后 发 送 给 A,A 收 到 消息 后 用 自己 的 私 钥 解 
密 ,就 能 看 到 消息 内 容 了 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 相关 的 变量 。 


string sampleTest = "The Dotnet Core App"; 
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byte[ ] key = null; 
byte[ ] encryptData = null; 


sampleTest 是 用 于 对 加 密 和 解密 进行 测试 的 字符 串 ,encryptData 表示 被 加 密 后 的 
数据 。 
步骤 3: 对 示例 字符 串 进行 加 密 。 


using (RSACryptoServiceProvider rsa = new RSACryptoServiceProvider()) 
{ 

// 导出 公 钥 与 私 钥 

key = rsa. ExportCspBlob(true); 


encryptData = rsa. Encrypt(FEncoding. RSCII. GetBytes(sampleTest), RSAEncryptionPadding. Pkcs1); 


因为 稍 后 要 对 数据 进行 解密 ,所 以 需要 调用 ExportCspBlob 方法 将 密 钥 导出 备用 。 
ExportCspBlob 方法 需要 一 个 bool 类 型 的 参数 ,表示 是 否 导出 私 钥 。 如 果 不 导出 私 钥 , 后 
面 就 无 法 解密 数据 了 ,所 以 此 处 应 该 设 定 为 true。 

步骤 4: 解密 数据 。 


using(RSACryptoServiceProvider rsa = new RSACryptoServiceProvider()) 


{ 
// 导入 公 钥 与 私 钥 
rsa. ImportCspBlob(key); 
byte[ ] bf = rsa.Decrypt(encryptData, RSAEncryptionPadding. Pkcs1); 
string restoreStr = Encoding.ASCII.GetString(bf); 
Console. Write( $ "解密 后 的 字符 串 :\n{restoreStr}"); 
} 


调用 ImportCspBlob 方法 后 ,会 导入 刚刚 导出 的 公 钥 和 私 钥 。 
步骤 $: 运行 应 用 程序 ,效果 如 图 13-5 所 示 。 


CProgramFiles\dotn.. 一 口 Xx 


13-5 ”RSA 算法 加 密 与 解密 


第 三 篇 ， ASP.NET Core 


ASP. NET Core 以 . NET Core 框架 为 基础 ,是 专 为 Web 开发 而 推 
出 的 扩展 框架 ,也 是 学 习 . NET Core 编程 的 一 个 重要 模块 。 通 过 学 习 
本 篇 ,读者 将 掌握 以 下 内 容 : 

。 Web Host 与 应 用 程序 的 初始 化 配置 ; 

。 中 间 件 的 运用 与 开发 ; 

。 服务 与 依赖 注入 ; 

。 MVC 模型 的 常用 技巧 

。 管理 应 用 程序 配置 (配置 文件 .环境 变量 、 选 项 类 ); 

。 Entity Framework (EF) Core( 包 括 实体 模型 的 构建 与 迁移 、 运 

行 时 创建 数据 库 等 )。 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 Web 主机 配置 ; 
*» Startup; 


。 启动 环境 。 
14.1 Web 主机 配置 


实例 326 ”使 用 默认 配置 创建 Web 主机 

【导语 】 

WebHost 是 一 个 静态 类 , 它 公 开 了 一 系列 简便 的 方法 ,可 以 使 用 各 项 默认 配置 参数 创 
建 Web 主机 ,其 中 用 得 较 多 的 是 CreateDefaultBuilder 方法 。CreateDefaultBuilder 方法 一 
般 使 用 默认 的 配置 来 创建 WebHostBuilder 实例 ,这 些 默认 的 配置 包括 : 

(1) 使 用 内 置 的 Kestrel 服务 器 组 件 , 能 够 使 Web 应 用 在 进程 中 独立 运行 。 

(2) 使 用 IIS 交互 。IIS 将 作为 反 向 代理 端 ,将 HTTP 请 求 转发 到 Web 应 用 程序 。 

(3) 将 应 用 程序 的 当前 目录 作为 Web 内 容 的 根 目录 。 


(4) 加 载 appsettings. json 或 appsettings. < 启动 环境 >. json 文件 来 对 应 用 程序 进行 
配置 。 


(5) 加 载 环境 变量 和 命令 行 参数 。 
(6) 记录 日 志 , 并 在 控制 台 窗 口 和 Visual Studio 的 “调试 "窗口 中 输出 日 志 信息 。 
调用 CreateDefaultBuilder 方法 并 返回 WebHostBuilder 实例 ,接着 调用 该 实例 的 Build 


方法 ,就 能 创建 WebHost 实例 了 ,最 后 调用 Run 扩展 方法 启动 Web 服务 器 ,Web 应 用 程序 
开始 执行 。 


【操作 流程 】 


步骤 1: 在 Visual Studio 开发 环境 中 ,依次 执行 菜单 “文件 ”一 “新建 > 一 项目” 命令 , 打 
开 “ 新 建 项 目 ” 窗 口 。 


步骤 2: 在 . NET Core 应 用 分 支 下 找到 “ASP. NET Core Web 应 用 程序 ”, 如 图 14-1 所 示 。 
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(3 ASP.NET Core Web 应 用 层 序 


pplicationm1 


图 14-1 选择 项 目 类 型 


步骤 3: 输入 项 目 /解决 方案 的 名 字 , 单 击 “确定 ”按钮 。 
步骤 4: 然后 会 打开 一 个 选项 窗口 ,在 窗口 中 选择 “ 空 ”( 即 空白 的 Web 应 用 程序 ) ,同时 
不 勾 选 窗口 下 方 的 “为 HTTPS 配置 "选项 (暂时 不 需要 HTTPS 配置 ), 如 图 14-2 所 示 。 


NET Core ~“]ASPNET Core 2.1 ~| 了 和 更 全 
用 于 创建 AsP NET Core 应 用 得 序 的 信 项 目 模板 此 模 
人 
回 中 板 中 设 有 任何 内 容 . 
= APl 。 ”Web 应 用 程序 Web 应 用 图 序 ”Razor 关 库 了 
(异型 栅 图 深 抽 
列 
LA 各 (3 
Angular Reactjs Reactjs 和 
Redux 
作者: Microsoft 
源 : SDK 2.1402 
口 启用 Docker 支持 四 身份 验证 ， 不 进行 身份 验证 
报 作 系统 。 Windows 从 A) 
要 求 下 于 Windows 的 Docker 
还 可 以 稍 后 启用 Docker 支持 了 名 更 全 
口 为 HTTPS 配置 (O) 
确证 (0) | | 了 RAO 


图 14-2 ”选择 Web 应 用 项 目 配置 
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步骤 5: 单 击 “ 确 定 ” 按 钮 ,创建 项 目 。 

步骤 6: 待 应 用 程序 项 目 创建 完成 后 ,找到 Program 类 ,并 定位 到 Main 方法 ,将 模板 默 
认 生 成 的 代码 删除 ,并 输入 以 下 代码 。 

IWebHostBuilder builder = WebHost. CreateDefaultBuilder(args). UseStartup < Startup>(); 

// 创建 Web 宿主 

IWebHost host = builder. Build(); 

// 启动 Web 主机 

host. Run(); 

调用 CreateDefaultBuilder 方法 之 后 ,还 需要 调用 UseStartup 方法 指定 一 个 类 ,这 个 类 
由 项 目 模板 默认 生成 ,并 命名 为 Startup。 初 始 化 Web 主机 时 需要 用 到 这 个 类 , 它 主要 负责 
配置 应 用 程序 要 用 到 的 服务 组 件 以 及 中 间 件 。 

CreateDefaultBuilder 方法 还 有 一 个 重 载 ,可 以 直接 指定 Startup 类 ,所 以 上 面 代码 可 以 
精简 为 以 下 形式 。 

IWebHostBuilder builder = WebHost.CreateDefaultBuilder < Startup >(args); 

调用 Run 方法 后 , Web 应 用 程序 就 处 于 运行 状态 ,直到 应 用 程序 退出 。 


步骤 7: 运行 应 用 程序 。 当 应 用 程序 启动 后 ,会 启动 默认 浏览 器 ,并 定位 到 指定 的 
URL, 如 图 14-3 所 示 。 


| Q localhost:51135/ 世 | 本 
这 是 一 个 简单 的 Web 应 用 ! 


图 14-3 在 浏览 器 查看 Web 应 用 的 运行 结果 


实例 327 配置 Web 服务 器 的 URL 


【导语 】 

对 Web 服务 器 的 配置 都 在 WebHostBuilder 对 象 上 完成 ,一 旦 调用 Build 方法 生成 服 
务 主机 后 就 不 要 再 更 改 配置 了 ,尤其 是 用 于 监听 客户 端 请 求 的 URL。 指 定 URL 的 方法 有 
很 多 种 ,比较 常用 的 有 以 下 三 种 : 

(1) 调用 UseUrls 方法 。 这 是 一 个 扩展 方法 , 它 的 内 部 调用 了 IWebHostBuilder 的 
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UseSetting 方法 。UseUrls 方法 使 用 可 变 个 数 的 字符 串 对 象 作为 参数 ,可 以 方便 地 指定 多 
个 URL。 

(2) 调用 UseSetting 方法 ,配置 的 key 参数 为 WebHostDefaults. ServerUrlsKey 字段 
( 即 字 符 串 “urls”) ,配置 的 值 是 一 个 单独 的 字符 串 实例 ,如 果 有 多 个 URL, 需 要 用 英文 的 分 
号 分 隔 。 

(3) 通过 配置 文件 ,如 默认 的 appsettings. json, 可 以 自 定义 文件 名 。 

URL 的 格式 一 般 为 “协议 方案 ”十 “主机 名 ”十 “端口 ”, 例 如 以 下 格式 。 


http://localhost:6000 


如 果 需 要 监听 本 机 某 个 端口 上 的 所 有 地 址 ,可 以 用 星 号 ( * ) 或 者 加 号 (十 ) 代 替 主 机 名 ， 
格式 如 下 。 

http://* :8005 

本 实例 将 演示 通过 三 种 方法 设置 Web 服务 器 的 URL。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 项 目 。 

步骤 2: 找到 Program 类 的 Main 方法 ,删除 里 面 的 代码 ,替换 为 以 下 代码 。 


var builder = new WebHostBuilder() 
.UseKestrel() 
.UseIISIntegration( ) 
.UseStartup < Startup>() 
.UseUrls("http://localhost:6500"); 
builder. Build().Run(); 


也 可 以 指定 多 个 URL。 
var builder = new WebHostBuilder() 
.UseUrls( "http://localhost:6500", "http://localhost:7000", "http://* :9730"); 
步骤 3: 使 用 UseSetting 方法 也 可 以 配置 URL。 
var builder = new WebHostBuilder() 
.UseSetting(WebHostDefaults. ServerUrlsKey, "http://localhost:8990"); 
如 果 要 配置 多 个 URL ,请 用 英文 的 分 号 隔 开 。 
var builder = new WebHostBuilder() 


.UseSetting(WebHostDefaults. ServerUrlsKey, "http://localhost:8990; 
http://localhost:46133"); 


第 14 章 ”应 用 启动 | 苏 421 


注意 ; UseSetting 方法 的 value 参数 是 单个 字符 串 实例 ,所 以 多 个 URL 都 是 用 一 个 字符 串 
实例 来 表示 的 ,这 与 UseUrls 方法 不 同 。 


步骤 4: 还 可 以 用 json 文件 配置 。 在 项 目 目 录 中 新 建 一 个 json 文件 ,假设 命名 为 host. 
json, 并 在 新 的 JSON 文件 中 输入 以 下 内 容 。 
{ 


urls" : "http://localhost:3600;http://* :80" 
$ 


步骤 5: 然后 回 到 Main 方法 ,对 代码 做 以 下 修改 。 
var builder = new WebHostBuilder() 
.UseStartup < Startup>(); 


ConfigurationBuilder config = new ConfigurationBuilder(); 
config. SetBasePath(builder. GetSetting(WebHostDefaults. ContentRootKey)) 
. AddJsonFile("host. json"); 

builder. UseConfiguration(config. Build( )); 

builder. Build().Run(); 

要 使 配置 生效 ,不 能 调用 ConfigureAppConfiguration 方法 ,因为 此 方法 仅 用 于 配置 应 
用 程序 级 别 的 参数 ,而 不 是 Web 主机 级 别 的 参数 。 此 时 需要 通过 ConfigurationBuilder 对 
象 生成 一 个 新 的 配置 对 象 ,然后 调用 UseConfiguration 方法 对 默认 的 配置 进行 覆盖 。 

SetBasePath 方法 的 作用 是 设 定 一 个 基础 的 目录 路 径 , 随 后 在 调用 AddjsonFile 方法 添加 
JSON 文件 时 ,只 需要 提供 文件 名 即 可 , 即 相对 路 径 ( 相 对 于 SetBasePath 方法 所 指定 的 路 径 ) 。 

步骤 6: 运行 应 用 程序 ,效果 如 图 14-4 所 示 。 


图 14-4 在 自 定 义 的 URL 上 监听 HTTP 请 求 


实例 328 ”使 用 Kestrel 服务 器 组 件 


【导语 】 
ASP. NET Core 应 用 程序 是 运行 在 独立 的 Web 服务 器 容器 中 的 , Web 服务 器 组 件 要 
求 必须 实现 IServer 接口 ,开发 者 可 以 自己 编写 服务 器 组 件 或 者 使 用 其 他 第 三 方 组 件 。 
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ASP. NET Core 框架 默认 实现 的 Web 服务 器 组 件 是 Kestrel。 

WebHost 类 的 CreateDefaultBuilder 方法 内 部 已 默认 使 用 Kestrel 服务 器 组 件 ,但 是 如 
果 开 发 者 自己 编写 代码 来 创建 Web 主机 (而 不 是 直接 调用 CreateDefaultBuilder 方法 ), 则 
必须 显 式 调 用 UseKestrel 扩展 方法 以 启用 Kestrel 服务 器 组 件 ,否则 运行 应 用 程序 后 会 报 
出 如 图 14-5 所 示 的 错误 。 


未 各 处 理 的 异 富 


System.InvalidOperationException:No service for type 


MicrosoftAspNetCore.Hosting.ServerlServer has been 
registered.” 


图 14-5 未 找到 已 注册 的 Web 服务 器 组 件 


【操作 流程 】 
步骤 1: 新建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 
步骤 2: 定位 到 项 目 模板 生成 的 Program. Main 方法 ,输入 以 下 代码 。 
var builder = new WebHostBuilder() 
.UseStartup < Startup>() 
.UseContentRoot(Directory. GetCurrentDirectory()) 


.UseKestrel(); 
builder. Build().Run(); 


步骤 3: IIS 集成 功能 是 可 选 的 ,只 有 在 使 用 IIS 作为 反 向 代理 时 才 有 效 ,要 启用 IIS 集 
成 可 以 调用 UseIISIntegration 方法 。 


var builder = new WebHostBuilder() 


.UseKestrel() 
.UseIISIntegration(); 
builder. Build(). Run(); 


实例 329 配置 Web 项 目的 调试 方案 


【导语 】 

在 创建 ASP. NET Core Web 项 目 后 ,模板 默认 生成 两 个 调试 方案 : 

(1) 以 IIS Express 为 反 向 代理 运行 应 用 程序 。 

(2) 用 项 目 名 称 命名 ,独立 运行 项 目 (通过 dotnet 命令 执行 )。 

开发 人 员 可 以 根据 实际 需要 对 调试 方案 进行 新 增 、 删 除 和 编辑 。 最 简单 的 配置 方法 是 
通过 项 目 属性 窗口 中 的 “调试 ”选项 卡 来 操作 。“ 调 试 " 页 面 的 配置 内 容 保 存在 项 目 目录 下 的 
\Properties\launchSettings. json 文件 中 ,文件 的 大 致 结构 如 下 : 
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{ 
"iisSettings": { 
"windowsAuthentication": false, 
"anonymousAuthentication": true, 
"iisExpress": { 
"applicationUrl": "http://localhost:53196", 
"sslPort": 0 
} 
}, 
"profiles": { 
"IIS Express": { 
"commandName" : "IISExpress", 
"launchBrowser" : true, 
"environmentVariables" : { 
"RSPNETCORE_FENVIRONMENT" : "Development" 
} 
}, 
"< 与 项 目 名 称 相同 >": { 
"commandName" : "Project", 
"launchBrowser" : true, 
"applicationUrl": "http://localhost:5000", 
"environmentVariables": { 
"ASPNETCORE_ENVIRONMENT" : "Development" 
} 
} 
} 
} 


其 中 ,profiles 字段 下 所 包含 的 内 容 就 是 调试 方案 列表 。 方 案 名 称 可 以 自 定义 (模板 生成 的 
默认 名 称 有 两 个 ,一 个 是 “IIS Express”, 另 一 个 与 项 目 同名 )。commandName 字段 用 于 描 
述 应 用 程序 在 调试 时 的 启动 方式 ,此 值 有 四 个 选项 : 

(1) IIS Express: 以 IIS Express 作为 反 向 代理 进程 。 

(2) IIS: 以 JIS 服务 (完整 版 IIS) 作 为 反 向 代理 进程 。 

(3) Project: 使 用 dotnet 命令 直接 运行 应 用 程序 (附加 . dll 文件 ) 。 

(4) Executable: 自 定义 一 个 可 执行 文件 ,这 种 调试 方案 一 般 不 常用 。 

commandName 字 段 之 后 的 各 字段 在 每 种 调试 方案 中 并 不 固定 ,例如 如 果 
commandName 指定 为 Executable, 那 么 随后 就 要 设置 executablePath 字段 以 表示 要 启动 
的 可 执行 文件 的 路 径 。 但 IIS Express 调试 方案 中 则 不 需要 executablePath 字段 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
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步骤 2: 项 目 创建 后 ,打开 项 目 属性 窗口 ,切换 到 “调试 ”选项 卡 页 ,如 图 14-6 所 示 。 


Web 服务 器 设置 


图 14-6 


ITS Express “| | 新 建 .- 量 除 
IIS Express b>} 
浏览 -- 
添加 
移 除 
| EE | 
应 用 URL(P): [http://localhost:53196 
TIS Express 位 数 B) -| 默认 值 
口 启用 ssL(s) 
网 启用 匿名 身份 验证 () 
口 自用 Tindows 身份 验证 (0) 


调试 方案 配置 页 面 


步骤 3: 单 击 “ 删 除 ” 按 钮 ,将 项 目 模板 默认 生成 的 调试 方案 全 部 删除 。 

步骤 4: 单 击 “ 新 建 ?按钮 ,弹出 “新 建 配置 文件 "对话 框 ,在 对 话 框 中 输入 一 个 自 定义 的 
名 称 , 如 图 14-7 所 示 。 

步骤 $: 在 “启动 * 下 拉 列 表 框 中 选择 “项 目 ”, 即 commandName 字段 为 Project 值 ,如 


图 14-8 所 示 。 


配置 文件 名 称 : 


RunAp 昌 


应 用 程序 参数 : 


EE 


图 14-7 为 新 的 调试 方案 命名 


图 14-8 选择 “项 目 ” 


步骤 6: 在 “环境 变量 ”中 添加 一 个 新 项 ,名 称 为 “ASPNETCORE_Environment”, 值 为 
“Development”, 如 图 14-9 所 示 。 


“ASPNETCORE_” 是 默认 的 环境 变量 前 级, 其 后 紧 跟 环境 变量 的 名 字 。 例 如 本 例 中 ， 


环境 变量 名 称 为 “Environment”, 它 表示 应 用 程序 运行 的 环境 ,预定 义 的 值 有 三 个 : 
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环境 变星 : 名 称 值 


ASPNETCORE_Enwvironment Development 


上 


图 14-9 添加 环境 变量 


Development、Staging、Production, 也 是 可 以 自 定义 的 。 

步骤 7: 在 “应 用 URL” 中 填写 Web 应 用 启动 时 监听 的 地 址 ,本 实例 中 使 用 的 地 址 为 
http: //localhost: 6000。 

步骤 8:( 可 选 ) 如 果 需 要 应 用 程序 在 启动 调试 时 自动 打开 浏览 器 ,可 以 勾 选 “ 启 动 浏览 
器 ” 复 选项 。 

步骤 9: 保存 并 关闭 项 目 属性 窗口 ,此 时 在 Visual Studio 的 调试 工具 按钮 的 级 联 菜单 
里 面 就 包含 自 定义 的 调试 方案 了 。 


14.2 Startup 


实例 330 ”基于 方法 约定 的 Startup 类 


【导语 】 

在 默认 的 项 目 模板 中 ,会 创建 一 个 Startup 类 ,并 通过 WebHostBuilder 的 扩展 方 
法 一 一 UseStartup 来 进行 配置 。Startup 并 未 要 求 类 名 必须 为 Startup, 可 以 自 定义 类 名 ,但 
要 求 类 中 必须 包含 约定 方法 (可 以 是 实例 方法 ,也 可 以 是 静态 方法 ) 。 约 定 方法 有 两 个 : 

(1) ConfigureServices 方法 : 这 个 约定 方法 是 可 选 的 , 当 需 要 向 容器 添加 服务 时 才 定 
义 。 该 方法 只 有 一 个 参数 ,类 型 为 IServiceCollection。 在 ConfigureServices 方法 内 部 可 以 
向 IServiceCollection 集合 添加 要 用 到 的 服务 类 型 。 

(2) Configure 方法 : 此 方法 是 必需 的 , 它 支 持 参数 的 依赖 注入 ,要 求 必须 包含 
IApplicationBuilder 类 型 的 参数 。 如 果 有 其 他 参数 存在 ,IApplicationBuilder 类 型 的 参数 要 
放 在 参数 列表 的 第 一 位 ,其 余 参 数 将 由 依赖 注入 来 赋值 。 

这 两 个 约定 方法 的 格式 如 下 : 

void ConfigureServices(IServiceCollection services); 

void Configure(IApplicationBuilder app [， < 接收 依赖 注入 的 参数 >]); 

应 用 程序 在 运行 时 会 查找 约定 方法 的 名 字 , 所 以 在 Startup 类 型 中 声明 时 ,方法 名 称 必 
须 正 确 ,否则 运行 时 将 因 找 不 到 约定 的 方法 而 发 生 错 误 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
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步骤 2: 删除 项 目 模板 生成 的 Startup 类 ,随后 重新 定义 一 个 ,并 且 类 名 为 MyStartup 。 


public class MyStartup 
{ 
public void ConfigureServices( IServiceCollection services) 
{ 
Ms 
} 


public void Configure( IApplicationBuilder app) 
f 
app. Run(async context => 
{ 
// 设置 文本 编码 
context. Response. ContentType = "text/html;charset = UTF — 8"; 


// 返回 消息 给 客户 端 
await context. Response. WriteAsync(" 这 是 一 个 Web 应 用 "); 


app. Run 方法 定义 如 何 处 理 HTTP 请 求 ,本 例 中 比较 简单 ,直接 向 客户 端 回 写 一 条 文 
本 消息 。 
步骤 3: 找到 Program 类 的 Main 方法 ,删除 项 目 模 板 生 成 的 代码 ,替换 为 以 下 代码 。 


public static void Main( string[ ] args) 
{ 
var builder = new WebHostBuilder() 
.UseContentRoot (Directory. GetCurrentDirectory()) 
.UseKestrel() 
.UseStartup < MyStartup>(); 
builder. Build(). Run(); 
E 


UseStartup 扩展 方法 指定 定义 好 的 类 一 一 MyStartup。 
实例 331 使 用 IStartup 接口 定义 Startup 类 


【导语 】 

不 仅 可 以 使 用 约定 方法 来 定义 Startup 类 ,还 可 以 通过 实现 IStartup 接口 来 定义 
Startup 类 。 此 接口 的 成 员 列 表 如 下 : 

public interface IStartup 

{ 


void Configure( IApplicationBuilder app); 
IServiceProvider ConfigureServices( IServiceCollection services); 
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从 接口 的 成 员 列 表 中 可 以 发 现 ,实现 该 接口 的 类 型 也 需要 公开 名 为 ConfigureServices 与 
Configure 的 方法 。 

同时 ,框架 提供 了 一 个 抽象 类 一 一 StartupBase, 这 个 类 已 经 实现 IStartup 接口 ,因此 既 
可 以 直接 实现 IStartup 接口 ,也 可 以 实现 StartupBase 抽象 类 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 删除 项 目 模板 默认 生成 的 Startup 类 。 

步骤 3: 重新 定义 Startup 类 ,并 实现 IStartup 接口 。 


public class Startup : IStartup 
{ 
public void Configurel( IApplicationBuilder app) 
{ 
app. Run(async (context) => 
. 
context. Response. ContentType = "text/html;charset = UTF — 8"; 
await context. Response. WriteAsync( "我 的 Web 应 用 程序 "); 
]) 
} 


public IServiceProvider ConfigureServices(IServiceCollection services) 
{ 
return services. BuildServiceProvider( ); 
} 
E 


由 于 这 种 Startup 类 的 实现 并 非 约 定 , 不 能 在 Configure 方法 上 接收 依赖 注入 的 对 象 ， 
但 可 以 通过 构造 函数 参数 来 注入。 


public class Startup : IStartup 
{ 
IHostingEnvironment hostEnv; 
public Startup( IHostingEnvironment env) 
{ 
_hostEnv = env; 
} 
} 
然后 可 以 在 Configure 方法 中 访问 。 


public void Configure( IApplicationBuilder app) 
{ 

app. Run(async (context) => 

{ 
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context. Response. ContentType = "text/html;charset = UTF— 8"; 
await context. Response. WriteAsync( $ "我 的 Web 应 用 程序 , 它 运行 在 
{_hostEnv. EnvironmentName} 环境 中 "); 


步骤 4: 运行 应 用 程序 ,在 浏览 器 中 将 看 到 如 图 14-10 所 示 的 内 容 。 


© localhos 六 [5 | 过 


我 的 Web 应 用 程序 ， 它 运行 在 
Development 环境 中 


图 14-10 浏览 器 输出 内 容 


实例 332 ”无 Startup 启动 应 用 程序 
【导语 】 
定义 Startup 类 (类 名 可 以 不 为 Startup) 只 是 为 了 配置 应 用 程序 时 方便 ,实际 启动 应 用 
程序 时 可 以 不 使 用 Startup 类 。 
IWebHostBuilder 接口 (默认 实现 类 是 WebHostBuilder) 公 开 了 ConfigureServices 方 
法 ,可 以 使 用 该 方法 来 添加 应 用 程序 需要 的 服务 。 此 外 ,可 以 调用 IWebHostBuilder 的 
Configure 扩展 方法 配置 应 用 程序 以 及 HTTP 通信 信道 。 具 备 了 ConfigureServices 方法 和 
Configure 方法 后 ,在 不 指定 Startup 类 型 的 情况 下 也 能 正常 运行 应 用 程序 。 
【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 
步骤 2: 删除 项 目 模板 生成 的 Startup 类 。 
步骤 3: 定位 到 Program 类 下 面 的 Main 方法 ,删除 默认 生成 的 代码 。 
步骤 4: 在 Main 方法 内 部 输入 以 下 代码 。 
IWebHostBuilder builder = new WebHostBuilder() 
.UseKestrel() 
.UseIISIntegration() 
.UseContentRoot(Directory. GetCurrentDirectory() ) 
.UseUrls("http://localhost:8605") 
.ConfigureServices(services => 
{ 
// 按 需 添加 服务 


}) 
.Configure(app => 
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app. Run(async context => 
‘ 
context. Response. ContentType = "text/plain;charset = UTF— 8"; 
await context. Response. WriteAsync(" 你 好 , Web 应 用 程序 !"); 
}); 
D); 
builder. Build().Run(); 


Configure 方法 接受 一 个 带 IApplicationBuilder | 旺 locah x | = 
类 型 参数 的 委托 ,处 理 方法 与 Startup. Configure 方 @ localhost8605/ 大 
法 一 样 。 本 实例 直接 调用 Run 方法 向 客户 端 回 写 一 
条 文本 消息 。 你 好 ，Web 应 用 程序 ! 

步骤 5: 运行 应 用 程序 。 

步骤 6: 在 浏览 器 地 址 栏 中 输入 http://localhost: 
8605 ,然后 按 下 Enter 键 ,会 看 到 如 图 14-11 所 示 的 


输出 。 图 14-11 无 Startup 类 型 启动 Web 应 用 
14.3 启动 环境 

实例 333 ”使 用 非 预 定义 环境 

【导语 】 


框架 预定 义 的 启动 环境 有 三 个 : 

(1) Development: 在 开发 阶段 使 用 。 例 如 在 此 启动 环境 中 ,应 用 程序 会 显示 详细 的 异 
常 信息 ,以 帮助 调试 。 

(2) Staging: 应 用 程序 正式 上 线 之 前 使 用 ,类 似 于 预览 版 本 。 

(3) Production: 应 用 程序 已 正式 上 线 并 投入 生产 时 使 用 。 例 如 此 环境 中 应 该 禁止 显 
示 异 常 详细 页 ,禁用 一 些 不 必要 的 日 志 以 提高 性 能 等 。 

预定 义 的 启动 环境 仅仅 是 个 参考 ,开发 人 员 可 以 根据 实际 的 开发 场景 自 定 义 启动 环境 
的 名 称 。 在 应 用 程序 的 任意 代码 中 ,随时 可 以 通过 访问 IHostingEnvironment. 
EnvironmentName 属性 来 检测 应 用 程序 当前 所 使 用 的 环境 ,也 可 以 调用 IEnvironment 扩 
展 方法 来 进行 判断 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定位 到 Program 类 下 的 Main 方法 ,删除 项 目 模板 生成 的 代码 ,并 输入 以 下 
代码 。 


var builder = new WebHostBuilder() 
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.UseEnvironment ("Preview") 
.UseKestrel() 
.UseUrls("http://localhost:6000") 
.UseContentRoot (Directory. GetCurrentDirectory()) 
.UseStartup < Startup >(); 

var host = builder.Build(); 

host. Run( ); 


UseEnvironment 扩展 方法 用 于 设置 应 用 程序 的 启动 环境 ,此 处 使 用 了 自 定义 名 称 


“Preview”。 
步骤 3: Startup 类 的 Configure 方法 支持 依赖 注入 ,因此 可 以 声明 IHostingEnvironment 
类 型 的 参数 以 接收 注入 ,随后 可 以 根据 应 用 程序 运行 环境 的 不 同 , 向 客户 端 返 回 不 同 的 消息 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 
app. Run(async (context) => 
{ 
context. Response. ContentType = "text/html;charset = UTF— 8"; 
string responseMessage = null; 
if(env. IsEnvironment("Preview")) 
{ 
responseMessage = "应 用 目前 仍 处 于 预览 阶段 "; 
a} 
else 
{ 
responseMessage = "应 用 已 正式 上 线 "; 桓 


© localhost:6000/ 女 


await context. Response. WriteAsync Rr 
(responseMessage); 


jy 应 用 目前 仍 处 于 预览 阶段 
} 
步骤 4: 运行 应 用 程序 ,并 从 浏览 器 中 访问 对 
应 的 URL。 由 于 设置 的 启动 环境 为 Preview, 因 此 
浏览 器 中 显示 “应 用 目前 仍 处 于 预览 阶段 ”", 如 图 14-12 应 用 程序 运行 在 自 定义 环境 中 
图 14-12 所 示 。 


实例 334 使 Startup 类 匹配 启动 环境 


【导语 】 

Startup 类 可 以 根据 不 同 的 环境 来 进行 匹配 ,匹配 方案 有 两 种 : 

(1) 类 型 匹配 , 即 通过 Startup 类 的 命名 来 与 环境 匹配 。 例 如 ,用 于 开发 环境 的 Startup 
类 可 以 命名 为 StartupDevelopment, 用 于 生产 环境 则 可 以 命名 为 StartupProduction。 命 名 
格式 为 : < 类 名 >{EnvironmentName} 。 
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(2) Startup 类 不 与 环境 匹配 ,而 是 使 约定 方法 与 环境 匹配 。Configure 方法 的 命名 格 
式 为 : Configure{EnvironmentName} ,例如 ConfigureDevelopment; ConfigureServices 方 
法 的 命名 格式 为 : Configure{EnvironmentName}Services, 例 如 ConfigureProductionServices。 

开发 者 不 仅 需 要 编写 特定 于 环境 的 Startup 类 ,还 应 该 编写 默认 的 Startup 类 ,这 样 如 
果 程 序 找 不 到 与 环境 匹配 的 Startup 类 ,还 可 以 使 用 默认 的 Startup 类 ( 即 不 带 有 
{EnvironmentName} 标 识 的 命名 )。 

本 实例 将 演示 为 Development 环境 编写 特定 的 Configure 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 类 中 ,定义 ConfigureDevelopment 方法 。 

public void ConfigureDevelopment( IApplicationBuilder app) 

{ 

app. Run(async context => 

{ 
context. Response. ContentType = "text/html;charset = UTF— 8"; 
await context. Response. WriteAsync(" 在 开发 环境 中 运行 "); 

D); 

} 

步骤 3: 运行 应 用 程序 ,由 于 在 默认 情况 下 项 目 模板 会 配置 为 Development 环境 ,因此 
会 调用 ConfigureDevelopment 方法 。 


依赖 注入 与 中 间 件 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 服务 ; 

。 依赖 注入 ; 

。 中 间 件 。 


15.1 服务 


实例 335” 枚 举 应 用 程序 中 已 添加 的 服务 


【导语 】 

ASP. NET Core 项 目 中 的 “服务 ”, 指 的 是 用 于 扩展 应 用 程序 功能 的 一 系列 类 型 。 在 应 
用 程序 初始 化 期 间 , 会 把 需要 的 服务 类 型 实例 添加 到 ServiceCollection 集合 中 ,这些 添加 到 
集合 中 的 服务 实例 将 通过 依赖 注入 提供 给 其 他 代码 使 用 (例如 可 以 注入 控制 器 的 构造 函 
数 中 ) 。 

本 实例 将 枚 举 在 应 用 程序 启动 期 间 添 加 到 ServiceCollection 中 的 服务 实例 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 输入 以 下 代码 ,初始 化 Web 服务 器 。 


var host = new WebHostBuilder() 
.UseContentRoot (Directory. GetCurrentDirectory()) 
.UseKestrel() 
.UseStartup < Startup >() 
.Build(); 
host. Run( ); 


步骤 3: 定位 到 Startup 类 的 ConfigureServices 方法 ,在 此 方法 中 对 services 参数 中 的 
元 素 进行 枚 举 。 


public void ConfigureServices( IServiceCollection services) 
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{ 
foreach (var sv in services) 
{ 
string msg = $ "服务 类 型 :{sv. ServiceType?. Name ?? "< 无 >"}"; 
msg += $", 实 现 类 型 :{sv. ImplementationType?. Name ?? "< 无 >"}"; 
Console. WriteLine(msg); 
} 
} 


步骤 4: 运行 应 用 程序 ,输出 的 服务 列表 如 图 15-1 所 示 。 


划 | 出 出 
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类 
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三 
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类 
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15-1 枚 举 应 用 程序 的 服务 列表 


实例 336 ”编写 服务 类 型 


【导语 】 

编写 服务 类 型 有 三 种 方案 : 四 先 定义 一 个 接口 ,然后 定义 一 个 类 去 实现 这 个 接口 ,再 将 
这 个 服务 接口 以 及 接口 的 实现 类 一 起 添加 到 IServiceCollection 集合 中 ; @ 先 定义 抽象 类 ， 
然后 定义 一 个 实现 该 抽象 类 的 新 类 ,再 将 这 个 抽象 类 与 它 的 实现 类 一 起 添加 到 
IServiceCollection 集合 中 ; @ 不 定义 接口 类 型 ,而 是 直接 定义 一 个 类 来 实现 服务 功能 ,然后 
把 这 个 类 添加 到 IServiceCollection 集合 中 。 

本 实例 将 分 别 演示 这 三 种 服务 的 实现 方案 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
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步骤 2: 第 一 个 服务 类 型 使 用 接口 与 实现 类 的 方式 定义 。 


public interface IServicel 


{ 
void OnAction(HttpContext context); 


internal class MyServicel : IServicel 


{ 
public void OnAction(HttpContext context) 


' 


_context. Response. Headers. Add( "addon", "Service 01"); 


步骤 3: 第 二 个 服务 类 型 使 用 抽象 与 实现 类 的 方式 实现 。 


public abstract class ServiceBase 


public abstract void OnBacked(HttpContext _context); 


internal class MYService2 : ServiceBase 


public override void OnBacked(HttpContext _context) 
{ 
_context. Response. Headers. Add( "returnBack", "Service 02"); 


} 
步骤 4: 第 三 个 服务 类 型 直接 定义 一 个 类 来 实现 。 


public class MyService3 

{ 
public void Checks(HttpContext context) 
{ 


_context. Response. Headers. Add( "checked", "Service 03"); 


} 
步骤 5: 定位 到 Startup 类 的 ConfigureServices, 依 次 将 上 述 三 种 服务 类 型 向 服务 容器 注册 。 


public void ConfigureServices(IServiceCollection services) 
{ 
services. AddSingleton < IServicel, MyServicel >(); 
Sservices. AddSingleton < ServiceBase, MyService2 >(); 
services. AddSingleton < MyService3 >(); 
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步骤 6: 在 Configure 方 法 的 参数 列表 中 加 上 以 上 三 个 服务 类 型 的 声明 ,以 实现 依赖 
计 。 


public void Configure( IApplicationBuilder app, IServicel svl, ServiceBase sv2, MyService3 sv3) 
{ 


} 


第 一 个 服务 使 用 其 定义 的 接口 IServicel 来 声明 参数 ,第 二 个 服务 使 用 抽象 类 
SerivceBase 来 声明 参数 ,最 后 一 个 服务 只 单独 由 一 个 类 实现 ,所 以 直接 用 MyService3 类 来 
声明 参数 。 

步骤 7: 在 app. Run 方 法 的 委托 内 部 ,依次 调用 三 个 服务 。 

app. Run(async (context) => 

{ 

sv1. OnAction(context); 
sv2. OnBacked( context); 
sv3.Checks(context); 
await context. Response. WriteAsync("Hello World! "); 
checked: Service_03 


D); 
步骤 8: 运行 应 用 程序 ,结果 如 图 15-2 所 示 。 EE 
三 个 服务 的 功能 都 是 使 用 HttpContext 对 象 添加 响应 消 。 Sever Kesrel 

息 的 HTTP 标 头 ,因此 当 实 例 应 用 运行 后 ,可 以 通过 浏览 器 的 9 


addon: Service 01 


“开发 人 员工 具 " 来 查看 被 添加 的 HTTP 标 头 。 et: 
实例 337 理解 服务 的 生命 周期 
【导语 】 


服务 类 型 添加 到 ServiceCollection 容器 后 ,其 生命 周期 将 由 框架 自动 管理 。 容 器 中 的 
服务 存在 三 种 生命 周期 : 

(1) 暂时 服务 : 通过 调用 AddTransient 方法 添加 。 暂 时 服务 的 生命 周期 是 最 短 的 , 它 
会 在 每 次 被 请 求 使 用 时 都 实例 化 一 次 ,属于 轻 量 级 服务 。 就 算是 在 同一 个 请 求 中 多 次 访问 ， 
暂时 服务 每 次 都 会 进行 实例 化 。 

(2) 作用 域 服务 : 这 个 “作用 域 ” 的 范围 是 单个 请 求 .通过 AddScoped 方法 添加 。 也 就 
是 说 在 单个 请 求 中 (从 客户 端 向 服务 器 发 出 请 求 到 服务 器 回 发 响应 消息 的 整个 过 程 ) ,不 管 
被 请 求 访问 多 少 次 ,作用 域 服务 都 只 进行 一 次 实例 化 。 

(3) 单 实 例 服务 : 通过 AddSingleton 方法 添加 。 此 种 服务 在 整个 应 用 程序 运行 期 间 只 
创建 一 个 实例 ,不管 有 多 少 次 请 求 ,也 不 管 被 请 求 访问 多 少 次 ,此 服务 只 实例 化 一 次 。 

本 实例 将 定义 四 个 服务 类 ,其 中 ,ServiceA 表示 暂时 服务 ,ServiceB 表示 作用 域 服务 ， 
ServiceC 表示 单一 实例 服务 ,以 及 ed i 服务 ,这 个 服务 比较 特殊 , 它 的 构 
造 函数 会 接收 来 自前 面 三 个 服务 的 依赖 注入 。 同 时 ,这 四 个 服务 都 会 注入 Demo 控制 器 的 
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构造 函数 中 , 即 在 一 个 Web 请 求 期 间 ,ServiceA、ServiceB 和 ServiceC 这 三 个 服务 被 访问 过 
两 次 。 第 一 次 被 访问 是 注入 Demo 控制 器 中 ,第 二 次 被 访问 是 注入 ServiceDependencyAll 
服务 中 ,并且 三 个 服务 类 在 实例 化 的 时 候 都 会 产生 一 个 新 的 GUID。 通 过 本 实例 ,可 以 直观 
地 看 到 容器 中 的 服务 在 各 种 生命 周期 下 的 状态 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 

步骤 2: 先 声明 一 个 ServiceBase 类 ,作为 后 面 三 个 服务 pe ,ServiceBase 类 的 
主要 功能 是 产生 新 的 GUID。 


public class ServiceBase 


{ 
public Guid ID { get; } 


protected ServiceBase() 
{ 
ID = Guid. NewGuid(); 
} 
} 


步骤 3: 从 ServiceBase 派生 出 三 个 类 ,这 三 个 类 就 是 本 实例 要 用 到 的 三 个 服务 。 


public sealed class ServiceA : ServiceBase { } 
public sealed class ServiceB : ServiceBase { } 
public sealed class ServiceC : ServiceBase { } 


步骤 4: 再 定义 第 四 个 服务 类 ,该 类 的 功能 是 在 构造 函数 中 接收 来 自前 三 个 服务 的 
注 碎 s 


public class ServiceDependencyAll 
{ 
public ServiceDependencyAll(ServiceA sva, ServiceB svb, ServiceC svc) 
{ 
Service A = sva; 
Service B = svb; 
Service C = sve; 


} 


public ServiceBase Service A { get; } 
public ServiceBase Service B { get; } 
public ServiceBase Service C { get; } 


请 求 依赖 注入 的 方法 很 简单 ,在 公共 构造 函数 中 声明 所 需要 服务 类 型 的 参数 即 可 , 当 框 
架 调 用 构造 函数 时 ,会 自动 给 参数 赋值 。 
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步骤 5: 定义 Demo 控制 器 ,在 其 构造 函数 中 ,接收 来 自述 四 个 服务 的 注入 。 


public class DemoController : Controller 
{ 
private readonly ServiceA _serviceR = null; 
private readonly ServiceB _serviceB = null; 
private readonly ServiceC serviceC = null; 
private readonly ServiceDependencyAll _serviceDep = null; 


public DemoController(ServiceA a, ServiceB b, ServiceC c,ServiceDependencyAll d) 
{ 

_serviceA = a; 

_serviceB = b; 

_serviceC = ci 

_serviceDep = d; 


} 
步骤 6: 在 Demo 控制 器 内 定义 Check 方法 ,作为 MVC 中 的 Action。 


public class DemoController : Controller 
{ 


public IActionResult Check() 
{ 
List< string> strLines = new List< string>(); 
strLines. Add( $ "暂时 服务 :{_serviceA. ID}"); 
strLines. Add( $ "作用 域 服务 :{_serviceB. ID}"); 
strLines. Add( $ "单一 实例 服务 :{_serviceC. ID}"); 
strLines. Add( string. Empty); 
strLines. Add(" 存 在 依赖 关系 的 服务 :"); 
strLines. Add( $ "暂时 服务 :{_serviceDep. Service_A. ID}"); 
strLines. Add( $ "作用 域 服务 :{_serviceDep. Service_B. ID}"); 
strLines. Add( $ "单一 实例 服务 :{_serviceDep. Service_C. ID}"); 
return View("~ /DemoView. cshtm]l", strLines); 


} 
步骤 7: 找到 Startup 类 的 ConfigureServices 方法 .把 前 面 定 义 的 四 个 服务 都 添加 到 服 
务 容 器 中 。 


public void ConfigureServices(IServiceCollection services) 
{ 


services. AddMvc( ); 
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services. AddTransient < ServiceA >(); 
services. AddScoped < ServiceB >(); 
services. AddSingleton< ServiceC >(); 


services.RddTransient < ServiceDependencyAll >(); 
} 


步骤 8: 运行 应 用 程序 ,在 浏览 器 中 打开 http: //< 实 际 URL >/Demo/Check, 就 可 以 从 
Web 页 面 上 看 到 各 种 服务 在 实例 化 时 产生 的 GUID 了 。 
步骤 9: 进行 三 次 请 求 测试 ,认真 观察 生成 的 GUID 以 寻找 规律 ,参照 表 15-1。 
表 15-1 三 次 请 求 产生 的 GUID 


第 一 次 请 求 Blocalhost 
匿 户口 会 © localhost54450/de 让 多 | 


暂时 服务 : 5caaebb9-2fd7-485a-9d77-d763cllbfe98 
| 作用 域 服务 : b8dec236-d8ff-4044-a002-a5276b2db0de 
| 单一 实例 服务 : a26ec491-c396-4b9c-8547-f56blf857cc6 


| 存在 依赖 关系 的 服务 : 

暂时 服务 : 9b20fdfc-52f6-4f5a-bc86-ee2072eab320 
作用 域 服务 : b8dec236-d8ff-4044-a002-a5276b2db0de 

| 单一 实例 服务 : a26ec491-c396-4b9c-8547-f56b1f857cc6 
| 


第 二 次 请 求 加 人 Som x 
二 曲 个 © localhost54450/de 妇 民 | oe 


暂时 服务 : lacff097-9fcf-4890-8165-52d2b5e97eaa 
| 作用 域 服务 : 325b2bc3-9cc2-4e60-bd9d-0b6d682c302b 
| 单一 实例 服务 : a26ec491-c396-4b9c-8547-f56b1f857cc6 


| 存在 依赖 关系 的 服务 : 

暂时 服务 : fbfec480-199c-4eb7-95ab-4195f098b58a 

| 作用 域 服务 : 325b2bc3-9cc2-4e60-bd9d-0b6d682c302b 
单一 实例 服务 : a26ec491-c396-4b9c-8547-f56b1f857cc6 


第 三 次 请 求 localhost 区 


和 SO © localhost54450/de 让 多 | 


| 暂时 服务 : 0a26c4d0-2e92-4bf5-a0c1-18cc898491ea 
作用 域 服务 : bdf04f4a-1421-4513-bbe9-e84352d013a0 
| 单一 实例 服务 : a26ec491-c396-4b9c-8547-f56b1f857cc6 


| 存在 依赖 关系 的 服务 : 

| 暂时 服务 : 5bd7eb89-d47b-458d-8d9b-31e2412e3287 
| 作用 域 服务 : bdf04f4a-1421-4513-bbe9-e84352d013a0 

| 单一 实例 服务 : a26ec491-c396-4b9e-8547-f56b1f857cc6 


从 测试 结果 可 以 发 现 : 在 同一 次 请 求 中 ,作用 域 服务 被 访问 了 两 次 ,但 GUID 是 相同 
的 ,说 明 它 在 同一 个 请 求 范 围 内 只 创建 了 一 个 实例 ; 而 暂时 服务 ,不 管 在 什么 范围 内 ,每 次 
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访问 它 所 产生 的 GUID 都 不 同 ,说 明 每 次 使 用 时 都 会 创建 新 实例 ; 单一 实例 服务 的 GUID 
始终 不 变 , 说 明 在 整个 应 用 程序 中 它 只 创建 了 一 个 实例 。 


15.2 依赖 注入 


实例 338 ”实现 SHA1 计算 服务 


【导语 】 

本 实例 将 编写 一 个 服务 类 ,用 于 计算 输入 文本 的 SHA1 哈 希 码 并 以 Base64 字符 串 的 
形式 返回 。 然 后 将 该 服务 类 注册 到 服务 容器 中 ,并 通过 构造 函数 注入 一 个 Razor Page 页 面 
模型 中 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 程序 项 目 。 

步骤 2: 定义 一 个 SHA1Computer 类 ,作为 计算 哈 希 码 的 服务 。 


public class SHAlComputer 
{ 
public string Compute( string input) 
{ 
byte[ ] data = Encoding. UTF8.GetBytes( input); 
byte[ ] res = null; 
using(SHRA1 sh = SHA1.Create()) 
{ 
res = sh.ComputeHash(data); 


y 
return Convert. ToBase64String(res); 


} 
步骤 3: 在 Startup 类 的 ConfigureServices 方法 中 注册 服务 类 。 


public void ConfigureServices( IServiceCollection services) 
{ 

services. AddMvc( ); 

services. AddScoped < SHAlComputer >( ); 
} 


由 于 本 实例 将 用 到 与 Razor Page 相关 的 功能 ,所 以 需要 调用 AddMvce 方法 添加 MVC 
框架 支持 。 

步骤 4: 在 Configure 方法 中 使 用 MVC 功能 。 

public void Configure( IApplicationBuilder app) 

{ 


app. UseMvc( ); 
} 
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上 述 代码 中 调用 AddMvc 方法 只 是 注册 MVC 相关 的 类 型 到 服务 容器 ,而 在 Configure 
方法 中 调用 UseMvc 方法 则 是 将 MVC 相关 的 中 间 件 添加 到 HTTP 通信 通道 中 。 
步骤 5: 定义 一 个 类 ,并 使 它 派生 自 PageModel 类 。 


public class TestModel : PageModel 
{ 


类 型 从 PageModel 类 派生 ,表明 它 是 一 个 Razor 页 面 模型 ,可 以 与 Razor 视图 文件 
关联 。 
步骤 6: 在 TestModel 页 面 模型 类 中 声明 SHA1Computer 服务 类 的 私有 字段 ,并 通过 
构造 函数 的 依赖 注入 来 获取 实例 引用 。 
readonly SHAlComputer _hash = null; 
public TestModel (SHAlComputer hs) 
{ 
_hash = hs; 
} 
步骤 7: 定义 OnGet 方法 ,返回 页 面 视图 。OnGet 是 一 个 约定 方法 ,以 HTTP-GET 方 
式 访 问 时 调用 。 
public PageResult OnGet() 
{ 
return Page( ); 
} 
Page 方法 返回 与 当前 页 面 模型 关联 的 页 面 视图 。 
步骤 8: 声明 两 个 属性 : InputText 属性 是 从 客户 端 输入 的 即将 要 进行 哈 希 计算 的 文 
本 ; HashedText 属性 则 是 哈 希 计算 结果 的 Base64 字符 串 。 
public string HashedText { get; private set; } 
[BindProperty] 
public string InputText { get; set; } 
其 中 ,InputText 属性 上 应 用 了 BindProperty 特性 ,作用 是 在 消息 往返 的 过 程 中 保留 该 
属性 的 值 。 如 果 不 添加 这 个 特性 , 当 服 务 器 将 视图 回 发 给 浏览 器 后 ,该 属性 的 值 会 丢失 。 
步骤 9: 定义 OnPostUpload 方法 ,在 方法 中 调用 SHA1Computer 服务 ,计算 在 视图 页 
面 中 输入 文本 的 哈 希 码 。 
public PageResult OnPostUpload() 
{ 
if (string. IsNullOrEmpty( InputText)) 


{ 
return Page(); 
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} 
HashedText = _hash. Compute(InputText); 
return Page( ); 


} 


步骤 10: 在 项 目 中 新 建 一 个 文件 夹 , 命 名 为 Pages, 这 是 Razor Page 中 页 面 视 图 的 默认 
查找 路 径 。 

步骤 11: 在 Pages 目录 下 新 建 一 个 Razor 视图 文件 (文件 后 级 为 . cshtml) ,在 文件 的 头 
部 添加 以 下 标记 。 


@page 

@namespace Demo 

@model TestModel 

@addTagHelper * ,Microsoft.AspNetCore.Mvc.TagHelpers 


“@” 符 号 是 Razor 语法 的 标志 ,在 Razor Page 视图 文件 的 第 一 行 必须 写 上 page 指令 
(主要 为 了 区 分 MVC 中 的 视图 )。 第 二 行 定义 此 Razor 视图 的 命名 空间 ,本 例 中 它 与 项 目 
的 默认 命名 空间 相同 ( 即 Demo)。 第 三 行 的 model 指令 很 重要 , 它 指定 与 该 视图 关联 的 页 
面 模型 类 ,此 处 要 指定 前 面 定 义 的 TestModel 类 。 第 四 行使 用 addTagHelper 指令 导入 所 
有 HTML 标记 扩展 帮助 器 ,其 中 * ( 星 号 ) 表 示 导 入 程序 集中 的 所 有 标记 帮助 器 类 型 ,后 面 
的 是 程序 集 的 名 称 。 

步骤 12: 编写 HTML 文档 。 

< html > 

<body> 
< form method = "post"> 
请 输入 文本 :< br/> 


< input type = "text" asp - for = "@Model. InputText" /> 
< input type = "submit" value = "提交 " asp- page 一 handler = "Upload" /> 


</form> 
< div> 
@I{ 
if (!string. IsNullOrWhiteSpace(Model. HashedText) ) 
{ 
<p> 
<fieldset> 
< legend > 处 理 结果 </legend> 
<span> 
@Model. HashedText 
</span> 
</fieldset > 
</p> 


} 
</div> 
</body> 
</html> 
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form 元 素 中 使 用 了 HTML 帮助 器 中 的 asp- 


page-handler, 用 来 指定 Page Model 类 中 使 用 哪个 方 | 


法 处 理 此 form 元 素 的 提交 操作 。 此 处 设置 的 
handler 名 称 为 Upload, 即 TestModel 类 中 的 


你 好 ， 欢 迎 来 到 这 里 提交 


OnPostUpload 方法 ,handler 无 须 指 定 约定 名 称 , 所 厂 处 理 结果 


以 OnPost 可 以 省 略 。 


| | 2AAL4wjqWcSyGEfBIjkHeWkLrjU= 


步骤 13, 运行 应 用 程序 ,在 浏览 器 打开 的 页 面 中 “页 15 4 量 示 输入 文本 的 只 项 值 


输入 文本 ,然后 单 击 “提交 ”按钮 ,就 能 看 到 计算 后 的 
SHAIL 哈 希 值 , 如 图 15-3 所 示 。 


实例 339 ”Startup. Configure 方法 的 依赖 注入 


【导语 】 

约定 方法 的 依赖 注入 , 较 常 见 的 有 两 种 用 法 : 

(1) Startup 类 的 Configure 方法 。 

(2) 作为 中 间 件 类 型 的 Invoke 方法 或 者 InvokeAsync 方法 。 

本 实例 演示 的 是 Startup. Configure 方法 的 依赖 注入 。 在 Configure 方法 中 接收 


ILogger 类 型 的 参数 注入 ,然后 调用 ILogger 的 成 员 方 法 来 记录 日 志 。 


可 


【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 在 Startup. Configure 方法 参数 中 定义 ILogger< TCategoryName > 的 参数 ,其 


bh TCategoryName 为 Startup 类 型 。 


public void Configure( IApplicationBuilder app, ILogger < Startup> logger) 
{ 


» 
步骤 3: 在 app. Run 方法 调用 前 后 记录 日 志 信 息 。 


public void Configure( IApplicationBuilder app, ILogger < Startup > logger) 
{ 
app. Run(async (context) => 
{ 
logger. LogInformation(">> 即将 调用 Run 方法 "); 
await context. Response. WriteAsync("Hello World!"); 
logger. LogInformation(">> Run 方法 调用 完成 "); 
D); 
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步骤 4: 运行 应 用 程序 ,结果 如 图 15-4 所 示 。 


图 15-4 ”控制 台 记录 的 日 志 


实例 340 ”临时 访问 服务 

【导语 】 

有 些 服务 类 型 可 能 要 在 应 用 程序 初始 化 的 过 程 中 临时 使 用 ,一 般 是 在 Main 方法 中 , 比 
较 典 型 的 用 途 就 是 数据 库 的 初始 化 。 在 启动 WebHost 之 前 ,程序 代码 可 能 要 检查 数据 库 
是 否 存在 ,如 果 不 存 在 就 创建 新 的 数据 库 , 然 后 写 入 一些 初始 数据 。 

当 应 用 程序 在 初始 化 过 程 中 需要 临时 访问 服务 类 型 时 ,可 以 调用 CreateScope 扩展 方 
法 (被 扩展 类 型 为 TIServiceProvider) 创建 一 个 基于 临时 作用 域 的 IServiceScope 对 象 ,然后 
再 通过 这 个 临时 的 IServiceScope 对 象 获取 服务 类 型 的 实例 。 由 于 服务 类 型 访问 完成 后 要 
释放 掉 IServiceScope 对 象 ,因此 建议 将 CreateScope 扩展 方法 的 调用 写 在 using 代码 块 中 ， 
以 便 自动 清理 。 

本 实例 将 演示 在 应 用 程序 初始 化 过 程 中 ,临时 获取 IHostingEnvironment 服务 实例 , 然 
后 修改 ApplicationName 属性 。 由 于 IHostingEnvironment 服务 在 容器 中 注册 的 是 单个 实 
例 , 所 以 修改 ApplicationName 属性 后 ,在 应 用 程序 的 其 他 地 方 进行 依赖 注入 也 能 获取 
ApplicationName 属性 的 最 新 值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 ,使 用 WebHost CreateDefaultBuilder 方法 快速 创建 WebHostBuilder， 
然后 创建 WebHost 实例 。 


var builder = WebHost.CreateDefaultBuilder(args); 
var host = builder 

.UseStartup< Startup >() 

.Build(); 


步骤 3: 临时 提取 IHostingEnvironment 实例 ,修改 ApplicationName 属性 。 


using( IServiceScope scope = host.Services.CreateScope()) 


{ 
IHostingEnvironment env = scope. ServiceProvider. GetRequiredService < IHostingEnvironment >(); 
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env. ApplicationName = 【实例 应 用 程序 】"; 
} 
步骤 4: 启动 WebHost 实例 。 
host. Run( ); 


步骤 $: 在 Startup. Configure 方法 中 ,可 以 通过 依赖 注入 从 参数 中 获取 IHostingEnvironment 
实例 ,然后 由 Response 对 象 向 客户 端 回 发 响应 消息 ,响应 消息 中 包含 ApplicationName 属 
性 的 值 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 


app. Run(async (context) => 日 ecah x 
i & 人 
context. Response. ContentType = "text/ | 
htnl;eharset = UT ~ 8") 正在 运行 【实例 应 用 程序 ] 


await context. Response. Writehsync( $ "正在 
运行 {env, ApplicationName}"); 
]) 
} | 
步骤 6: 运行 应 用 程序 ,浏览 器 中 得 到 的 返回 结 图 15-5 输出 ApplicationName 属性 的 值 
果 如 图 15-5 所 示 。 


15.3 中间 件 


实例 341 以 委托 形式 定义 中 间 件 


【导语 】 
应 用 程序 对 HTTP 请 求 的 处 理 过 程 进行 划分 ,每 个 环节 称 为 中 间 件 ,将 各 个 中 间 件 串 
联 起 来 ,就 形成 了 HTTP 管道 ,大 致 的 流程 可 参考 图 15-6。 


图 15-6 HTTP 通信 管道 示意 图 
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执行 中 间 件 的 顺序 与 它们 添加 到 HTTP 管道 的 顺序 相同 , 即 先 添加 的 中 间 件 会 先 执 
行 。 在 HTTP 管道 中 添加 中 间 件 有 三 种 方法 : 

(1) 委托 。 中 间 件 专用 的 委托 类 型 为 RequestDelegate, 对 应 的 方法 结构 就 是 带 
HttpContext 类 型 的 输入 参数 ,并 返回 Task 对 象 。 一 般 来 说 ,委托 方式 适用 于 代码 量 较 少 、 
处 理 逻 辑 比较 简单 的 中 间 件 。 

(2) 基于 约定 的 中 间 件 类 。 主 要 的 约定 在 于 类 的 方法 ,基于 约定 的 中 间 件 类 必须 包含 
Invoke 或 InvokeAsync 方法 ,输入 参数 为 一 个 HttpContext 对 象 ,并 返回 Task 对 象 。 中 间 
件 类 可 以 通过 构造 函数 的 依赖 注入 来 获取 下 一 个 中 间 件 的 Invoke 或 InvokeAsync 方法 
引用 。 

(3) 实现 IMiddleware 接口 。 该 接口 同样 包含 InvokeAsynec 方法 ,需要 HttpContext 
对 象 作为 输入 参数 ,并 返回 Task 类 型 的 对 象 。 用 这 种 方式 定义 的 中 间 件 需要 在 代码 中 显 
式 将 其 添加 到 服务 容器 中 ,因此 此 种 中 间 件 的 生命 周期 可 以 被 改变 (前 面 两 种 方式 所 定义 的 
中 间 件 都 是 单 实例 模式 ,在 应 用 程序 生命 周期 内 仅 创 建 一 次 实例 ,而 实现 了 IMiddleware 接 
口 的 中 间 件 在 添加 到 服务 容器 时 可 以 手动 设置 它 的 生命 周期 ) 。 

在 每 个 中 间 件 的 实现 代码 中 都 会 通过 输入 参数 获得 下 一 个 中 间 件 的 引用 ,这 样 开发 人 
员 可 以 灵活 控制 : 是 先 执行 当前 中 间 件 的 代码 ,还 是 先 执 行 下 一 个 中 间 件 的 代码 ,或 者 不 执 
行 下 一 个 中 间 件 而 直接 向 客户 端 回 写 响应 消息 。 

本 实例 将 演示 通过 委托 的 方式 来 定义 中 间 件 。 实 例 创 建 了 三 个 中 间 件 ， ac 和 
件 的 代码 中 产生 一 个 字符 串 ( 临 时 存储 在 HttpContext 对 象 的 Items 属性 中 ) ,在 最 后 
中 间 件 中 ,将 三 个 字符 串 拼接 并 发 回 给 客户 端 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup. Configure 方 法 中 ,调用 Use 扩展 方法 定义 三 个 中 间 件 。 


app. Use(async (context, next) => 
{ 
context. Items["linel"] = "第 一 环节 ,完成 "; 
await next( ) 
}) 
.Use(async (context, next) => 
{ 
context. Items[ "line2"] = "第 二 环节 ,完成 "; 
await next(); 
]) 
.Use(async (context, next) => 
{ 


context. Items["line3"] = "第 三 环节 ,完成 "; 

// 拼接 回应 消息 

var parts = (from o in context. Items select o0.Value.ToString()).AsEnumerable(); 
string responseMessage = string.Join("<br/>", parts); 
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// 设置 编码 
context. Response. ContentType = "text/html;charset = UTF— 8"; 
await context. Response. WriteAsync(responseMessage); 
await Task. CompletedTask; 
]) 


第 三 个 中 间 件 的 代码 中 ,可 以 不 调用 next 委托 引用 ,因为 该 中 间 件 已 经 是 HTTP 管道 
中 的 最 后 一 个 环节 了 。 


注意 : Response. Write 方法 一 般 是 在 最 后 一 个 中 间 件 里 面 调用 , 即 在 所 有 HTTP 通信 环节 
都 处 理 完毕 后 才 调 用 该 方法 。 一 旦 调用 Write 方法 ,就 开始 向 客户 端 回 写 消息 了 ,这 
会 导致 HTTP 消息 中 某 些 内 容 无 法 被 修改 (例如 HTTP 头 ), 进 而 引发 异常 ,所 以 最 
佳 做 法 是 待 所 有 环节 都 处 理 完成 了 再 将 消息 发 回 客户 端 。 当 然 ,任何 中 间 件 的 代码 
中 都 可 以 通过 访问 HasStarted 属性 来 确定 HTTP 响应 是 否 已 经 开始 发 回 给 客户 端 ， 
如 果 值 为 true, 就 不 应 该 再 修改 HTTP 头 了 。 


步骤 3: 运行 应 用 程序 ,浏览 器 输出 结果 如 图 15-7 所 示 。 
-— > EE 
ce DO localhos [7 妇 S| 

第 一 环节 ,完成 

第 二 环节 ， 完 成 

第 三 环节 ， 完 成 


图 15-7 三 个 中 间 件 的 处 理 结果 


实例 342 ”定义 中 间 件 类 


【导语 】 

本 实例 将 演示 通过 约定 方式 定义 中 间 件 类 。 一 般 来 说 ,中 间 件 类 的 命名 可 以 带 上 
“Middleware" 后 组 ,这 虽然 不 是 语法 要 求 ,但 是 有 规律 的 命名 方式 可 以 方便 其 他 人 识别 该 
类 是 中 间 件 。 

中 间 件 类 的 约定 中 必须 包含 Invoke 或 者 InvokeAsync 方法 ,此 方法 的 声明 如 下 : 

public Task InvokeAsync(HttpContext context); 

public Task Invoke (HttpContext context); 

除了 HttpContext 类 型 的 参数 外 ,还 可 以 在 该 方法 的 后 面 定义 其 他 参数 ,而 且 参 数 支 持 
依赖 注入 。 
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【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 定义 SampleMiddleware 类 , 它 表示 一 个 中 间 件 。 


public class SampleMiddleware 
{ 
// 下 一 个 中 间 件 的 引用 
private readonly RequestDelegate m next; 
public SampleMiddleware(RequestDelegate next) 
{ 
m next = next; 


} 


public async Task InvokeAsync(HttpContext context) 

{ 
await context. Response. WriteAsync("Hello Web"); 
// 调用 下 一 个 中 间 件 


await m next(context); 


注意 : 基于 约定 的 中 间 件 类 的 构造 函数 可 以 接收 下 一 个 中 间 件 引用 的 依赖 注入 ,但 是 不 应 
该 使 用 该 构造 函数 来 接收 其 他 服务 的 依赖 注入 ,因为 中 间 件 类 的 生命 周期 与 根 容器 
相同 ,在 应 用 程序 运行 期 间 只 创建 一 次 实例 ,如 果 在 构造 函数 中 接收 服务 类 的 依赖 注 
入 ,会 由 于 始终 保持 实例 的 引用 而 强制 服务 类 的 生命 周期 变 为 单个 实例 模式 。 


步骤 3: 在 Startup. Configure 方法 中 ,调用 
UseMiddleware 扩展 方法 将 自 定义 的 中 间 件 类 添加 ee 
到 HTTP 通信 管道 中 。 < © loca 廊 | 区 


HelloWeb 


public void Configure ( IApplicationBuilder app, 
IHostingEnvironment env) 


{ 


app. UseMiddleware < SampleMiddleware >(); 15-8 自 定义 中 间 件 类 的 调用 结果 
} 


步骤 4: 运行 应 用 程序 ,结果 如 图 15-8 所 示 。 


实例 343 ” 带 参数 的 中 间 件 


【导语 】 
中 间 件 允许 使 用 参数 ,但 并 不 是 调用 参数 ,而 且 仅 能 在 中 间 件 注册 时 使 用 , 即 在 中 间 件 
的 生命 周期 内 ,参数 只 传递 一 次 。 中 间 件 的 参数 是 通过 构造 函数 传递 的 , 即 在 定义 中 间 件 类 
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的 构造 函数 时 ,第 一 个 参数 是 HTTP 管道 中 下 一 个 中 间 件 的 引用 (RequestDelegate 委托 )， 
从 第 二 个 参数 开始 可 以 定义 中 间 件 的 参数 。 

当 在 Startup. Configure 方法 中 通过 UseMiddleware 方法 注册 中 间 件 时 ,可 以 传递 参 
数 。 如 果 中 间 件 是 基于 约定 所 定义 的 类 ,那么 传递 的 参数 值 尽 量 不 要 使 用 服务 容器 中 非 单 
实例 模式 的 服务 类 型 ,因为 这 种 中 间 件 在 应 用 程序 运行 期 间 只 实例 化 一 次 ,中 间 件 实例 始终 
会 保留 对 参数 的 引用 ,这 会 使 暂时 服务 或 作用 域 服务 的 实例 强制 变 成 单 实例 服务 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 一 个 中 间 件 类 。 


public class CalcuMiddleware 
{ 
readonly RequestDelegate next; 
readonly int a, _b; 
public CalcuMiddleware( RequestDelegate next, int a, int b) 
{ 
_next = next; 
a=a; 


»: mw bs 


} 


public async Task InvokeAsync(HttpContext context) 

{ 
int result = ax b; 
context. Response. ContentTYpe = "text/html;charset = UTF— 8"; 
await context. Response. WriteAsync( $ "{_a} x {_b} = {result}"); 
await next(context); 


} 
该 中 间 件 通过 构造 函数 来 接收 两 个 int 类 型 的 


参数 ,并 在 InvokeAsync 方法 中 计算 两 个 参数 的 乘 | 
积 ,将 结果 回 写 给 客户 端 。 | 0 
步骤 3: 在 Startup. Configure 方法 中 注册 中 间 15x7=105 


件 , 并 传递 参数 值 。 


app. UseMiddleware< CalcuMiddleware >(15, 7); 


步骤 4: 运行 应 用 程序 ,结果 如 图 15-9 所 示 。 图 15-9 输出 两 个 中 间 件 参数 的 乘积 
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实例 344 ”IMiddleware 接口 的 用 途 

【导语 】 

中 间 件 类 一 般 的 实现 方法 是 使 用 约定 形式 (包含 公共 的 Invoke 或 者 InvokeAsync 方 
法 ), 有 时 也 可 以 考虑 实现 IMiddleware 接口 ,该 接口 的 原型 如 下 : 


public interface IMiddleware 
{ 

Task InvokeAsync(HttpContext context, RequestDelegate next); 
有 


IMiddleware 接口 也 包含 InvokeAsync 方法 ,但 它 有 两 个 参数 , context 参数 表示 请 求 的 上 
下 文 数据 ,next 表示 下 一 个 中 间 件 的 引用 。 

基于 约定 的 中 间 件 类 在 应 用 程序 运行 期 间 只 创建 单个 实例 ,而 实现 了 IMiddleware 接 
口 的 中 间 件 类 的 生命 周期 就 可 以 灵活 控制 。IMiddleware 接口 方式 实现 的 中 间 件 ,在 
Startup。Configure 方法 中 调用 UseMiddleware 方法 之 前 ,必须 在 Startup. 
ConfigureServices 方法 中 进行 注册 ,服务 的 注册 可 以 选择 三 种 生命 周期 : 暂时 服务 .作用 域 
服务 和 单一 实例 服务 ,可 以 通过 不 同 的 服务 注册 方式 来 控制 中 间 件 类 的 生命 周期 ,例如 ,对 
于 不 太 常 用 的 中 间 件 ,可 以 注册 为 暂时 服务 ,减少 内 存 占 用 。 

【操作 流程 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 中 间 件 类 TestMiddleware, 并 让 它 实现 IMiddleware 接口 。 


public class TestMiddleware : IMiddleware 
{ 
public TestMiddleware( ) 
{ 
Console. WriteLine( $ "类 {GetType( ). Name} 的 构造 函数 被 调用 "); 
} 
public async Task InvokeAsync(HttpContext context, RequestDelegate next) 
{ 
// 添加 两 个 响应 头 
context. Response. Headers["item 1"] "hello"; 


"hi"; 


context. Response. Headers[ "item 2"] 
// 写 和 人 响应 消息 

context. Response. ContentTYpe = "text/html;charset= UTF— 8"; 
await context. Response. WriteAsync(" 欢 迎 来 到 主页 "); 


} 

在 TestMiddleware 类 的 构造 函数 中 会 输出 一 行文 本 ,因此 如 果 中 间 件 在 应 用 程序 运行 
期 间 被 多 次 创建 实例 ,那么 每 次 实例 化 的 时 候 都 会 在 控制 台中 输出 一 行文 本 ,通过 查看 控制 
台 的 输出 内 容 就 可 以 验证 中 间 件 是 否 被 多 次 实例 化 。 
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步骤 3: 在 Startup. ConfigureServices 方法 中 ,对 TestMiddleware 中 间 件 进行 注册 。 


public void ConfigureServices(IServiceCollection services) 


{ 
services. AddTransient < TestMiddleware >(); 


} 


注意 : 通过 实现 IMiddleware 接口 来 定义 的 中 间 件 ,必须 先 在 服务 容器 中 注册 才能 在 
HTTP 管道 中 使 用 。 


步骤 4: 在 Startup. Configure 方法 中 ,使 用 自 定义 中 间 件 。 
app. UseMiddleware < TestMiddleware >( ); 


步骤 5: 运行 应 用 程序 ,在 浏览 器 打开 URL 后 ,进行 多 次 刷新 。 可 以 发 现 , 每 次 刷新 后 
控制 台中 都 会 输出 一 行文 本 ,表明 TestMiddleware 中 间 件 创建 了 新 实例 ,如 图 15-10 所 示 。 


15-10 中间 件 被 多 次 实例 化 


实例 345 让 HTTP 管道 短路” 

【导语 】 

直接 调用 IApplicationBuilder 的 Run 扩展 方法 会 使 整个 HTTP 请 求 管道 发 生 * 短 
路 ?一 一 直接 把 响应 消息 发 回 给 客户 端 , 终 止 此 次 HTTP 通信 。 例 如 以 下 代码 调用 了 三 次 
Run 方法 : 

app. Run(async context => 

{ 


await context. Response. WriteAsync("Hello"); 


D); 


app. Run(async context => 


await context. Response. WriteAsync("My"); 
); 
app. Run(async context => 


await context. Response. WriteAsync( "Friends" ) 
); 
应 用 程序 在 运行 的 时 候 ,只 有 第 一 个 Run 方法 的 调用 会 被 执行 ,后 面 两 次 调用 都 不 会 被 执 
行 。 这 是 因为 遇 到 了 Run 方法 ,意味 着 整个 HTTP 请 求 管道 将 被 终结 ,并 且 将 处 理 结果 直 
接 发 回 给 客户 端 ,不 管 Run 后 面 还 有 没有 新 插入 的 中 间 件 ,都 不 会 被 执行 。 读 者 可 以 参考 
以 下 Run 扩展 方法 的 源 代码 。 


public static void Run(this IApplicationBuilder app, RequestDelegate handler) 


if (app == null) 
{ 

throw new ArgumentNullException(nameof (app) ) ; 
} 


if (handler == null) 
1 

throw new ArgumentNullException(nameof (handler) ); 
} 


app.Use(_ => handler); 
’ 
可 以 看 到 ,使 HTTP 管道 “短路 ”的 实现 原理 非常 简单 ,就 是 在 管道 中 插入 一 个 中 间 件 
( 即 传递 给 Run 方法 的 委托 实例 ) ,一 旦 这 个 中 间 件 执行 之 后 ,就 不 会 去 调用 下 一 个 中 间 件 ， 
从 而 使 HTTP 管道 终结 , 即 Run 方法 中 添加 的 中 间 件 成 为 HTTP 请 求 处 理 流 程 中 的 最 后 
环节 。 
【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 项 目 模板 在 Startup. Configure 方法 中 已 经 生成 了 一 条 调用 Run 方法 的 代码 
语句 。 为 了 演示 ,可 以 对 其 做 以 下 修改 。 
app. Run(async context => 
{ 
context. Response. ContentType = "text/html;charset = UTF— 8"; 


await context. Response. WriteAsync(" 你 好 , 世界 "); 
D); 
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步骤 3: 以 下 代码 也 能 实现 与 Run 方法 类 似 的 效果 。 


app. Use(async (context, next) => 

{ 
context. Response. ContentType = "text/html;charset = UTF— 8"; 
await context. Response. WriteAsync(" 你 好 ,世界 "); 

}); 


实例 346 ”中 间 件 的 分 支 喘 射 


【导语 】 

添加 到 HTTP 管道 的 中 间 件 是 默认 响应 根 URL 请 求 的 ,但 在 实际 开发 中 ,有 了 时候 需要 
在 根 URL 下 面 通过 子路 径 来 区 分 不 同 的 功能 , 即 根据 不 同 的 子 URL 来 调用 不 同 的 中 
间 件 。 

分 支 映射 有 两 种 比较 常见 的 使 用 场景 : 一 种 用 法 是 错误 处 理 ,例如 根 URL 是 http: // 
abc. org, 可 以 将 http: //abc. org/errors 专用 于 错误 处 理 ,调用 向 客户 端 返回 错误 信息 的 中 
间 件 ; 另 一 种 用 法 是 Web Socket, 例如 http: //abc. org/ws 分 支 可 专用 于 Web Socket 
通信 。 

本 实例 将 在 根 URL 的 基础 上 划分 三 个 分 支 , 当 访 问 /home 路 径 时 返回 文本 “主页 ”, 当 
访问 /about 路 径 时 返回 文本 “关于 本 站 ”, 访 问 /news 路 径 时 就 返回 文本 “新 闻 列 表 ”。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 首先 在 Startup. Configure 方法 中 定义 一 个 HTTP 管道 主 路 上 的 中 间 件 ,作用 
是 将 回 写 文本 的 字符 编码 设置 为 UTF-8。 


app. Use(async (context, next) => 

{ 
context. Response. ContentType = "text/html;charset = UTF — 8"; 
await next(); 

DD); 


注意 : 在 设置 完 字符 编码 后 ,必须 要 调用 next 委托 ,这 样 接 下 来 的 各 个 分 支 中 的 中 间 件 才 
能 被 调用 。 因 为 如 果 不 调用 next 委托 ,就 会 直接 终结 HTTP 管道 (与 在 主 路 上 调用 
Run 方法 结果 相同 )。 


步骤 3: 接 下 来 是 三 个 分 支 ,分 别 调用 Run 方法 向 客户 端 返回 文本 内 容 ,HTTP 管道 中 
的 处 理 过 程 结束 。 


app. Map("/home", _app => 
{ 
_app. Run(async context => 
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{ 
await context. Response. WriteAsync(" 主 页 "); 
D); 
) 
.Map("/about", app => 


_app. Run(async context => 
{ 
await context. Response. WriteAsync(" 关 于 本 站 "); 
D); 
) 
‘Map("/news", _app => 


_app. Run(async context => 
{ 
await context. Response. WriteAsync(" 新 闻 列 表 "); 
D); 
); 


步骤 4: 运行 应 用 程序 ,可 以 分 别 输入 以 下 URL 来 进行 测试 。 


http://localhost:3125/home 
http://localhost:3125/about 
http://localhost:3125/news 
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MVC 与 Web API 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 Razor 面向 Web 页 的 应 用 程序 ; 

。 MVC 与 Web API; 

。 访问 静态 文件 。 


16.1 Razor Web 页 面 应 用 


实例 347” 自 定 义 Razor 页 的 根 目 录 

【导语 】 

Razor 页 面 应 用 是 MVC 框架 的 一 种 简化 应 用 , 它 与 传统 的 Web 开发 模式 相似 ,以 页 面 
为 单位 来 划分 应 用 功能 。 

Razor 页 面 在 项 目 中 的 默认 存储 路 径 是 /Pages 目录 , 即 所 有 Razor 页 面 必 须 放 在 该 目 
录 下 。 而 请 求 的 URL 中 是 不 包含 根 目录 名 字 的 ,例如 某 个 页 面 文件 的 路 径 为 /Pages/ 
News/List. cshtml, 那 么 请 求 该 页 面 的 URL 应 为 http: //< 域 名 /端口 >/News/List。 如 果 
不 想 将 Razor 页 面 放 到 /Pages 目录 下 ,可 以 通过 RazorPagesOptions 选项 类 的 
RootDirectory 属性 来 配置 自 定义 的 页 面 存 放 路 径 。 配 置 代码 应 写 在 Startup. 
ConfigureServices 方法 中 ,例如 : 

services. AddMvc( ); 


services. PostConfigure < RazorPagesOptions >(option => 


{ 


option. RootDirectory = "/CustPages"; 


D); 
/CustPages 就 是 自 定 义 的 用 于 存储 Razor 页 面 的 根 目录 (相对 于 项 目的 根 目录 )。 
也 可 以 使 用 扩展 方法 来 简单 配置 。 


services. AddMvc( ) . WithRazorPagesRoot("/CustPages" ); 


第 16 章 MVC 与 Web AP| | 455 


如 果 和 希望 把 项 目 所 在 的 目录 直接 作为 Razor 页 面 的 根 目录 ,可 以 按 以 下 方式 配置 。 

services. AddMvc( ). WithRazorPagesRoot("/"); 

也 可 以 调用 WithRazorPagesAtContentRoot 扩展 方法 直接 配置 。 

services. RddMvc( ). WithRazorPagesAtContentRoot( ); 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Starutp. ConfigureServices 方法 中 调用 AddMvc 方法 添加 与 MVC 有 关 的 
服务 ,然后 配置 Razor 页 面 的 根 目录 。 


public void ConfigureServices(IServiceCollection services) 


{ 
services. RddMvc( ). WithRazorPagesRoot("/DemoPages"); 


} 
步骤 3: 在 Startup. Configure 方法 中 ,调用 UseMvc 方法 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 


{ 
if (env. IsDevelopment( )) 


{ 
app. UseDeveloperExceptionPage( ); 


} 


app. UseMvc( ); 


注意 : ConfigureServices 方法 中 必须 调用 AddMvc 方法 来 注册 与 MVC 框架 相关 的 服务 组 
件 , 在 Configure 方法 中 要 调用 UseMvc 方法 ,将 MVC 相关 的 中 间 件 添加 到 HTTP 
管道 中 ,这 样 应 用 程序 才能 通过 MVC 框架 来 处 理 HTTP 请 求 。 


步骤 4: 在 应 用 程序 项 目 中 新 建 一 个 文件 夹 ,命名 为 DemoPages (与 上 文中 
WithRazorPagesRoot 方法 指定 的 目录 匹配 )。 

步骤 $: 在 DemoPages 目录 下 面 新 建 一 个 Razor 代码 文件 ,命名 为 default. cshtml, 并 
在 该 文件 中 输入 以 下 内 容 。 


@page 


<html> 
<body> 
<h3 > 欢迎 </h3 > 
<h6 > 这 是 我 们 的 主页 </h6 > 
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</body> 

</html > 

Razor 页 面 与 MVC 中 的 Razor 视图 文件 一 样 ,使 用 的 都 是 Razor 标记 语法 ,不 同 的 是 ， 
用 于 MVC 视图 的 Razor 文件 是 没有 @page 指令 的 。 

步骤 6: 运行 应 用 程序 ,在 浏览 器 中 输入 地 址 http: //< 主 机 与 端口 >/default, 结 果 如 
图 16-1 所 示 。 


ey © localhost:6210/d 六 
欢迎 
这 是 我 们 的 主页 


图 16-1 自 定义 目录 下 的 Razor 页 面 


实例 348 ”Razor 页 面 与 页 面 模型 关联 


【导语 】 

Razor 代码 文件 只 要 在 文档 的 首 行 加 上 @page 指令 ,并 且 将 Razor 页 面 放 在 应 用 程序 
所 配置 的 根 目录 下 (默认 为 /Pages) ,就 可 以 在 URL 中 通过 页 面 来 访问 了 。 但 是 ,如 果 页 面 
涉及 相对 复杂 的 业务 逻辑 处 理 , 就 需要 创建 一 个 页 面 模 型 类 (Page Model) 来 编写 独立 的 处 
理 代码 ,使 得 视图 与 代码 分 离 ,便于 管理 和 维护 。 

页 面 模型 类 需要 从 PageModel 类 (位 于 Microsoft. AspNetCore. Mvc. RazorPages 命名 
空间 ) 派 生 。 页 面 模型 类 中 通过 声明 符合 约定 的 方法 与 视图 逻辑 交互 ,页面 视图 通过 一 个 名 
为 handler 的 路 由 参数 来 调用 这 些 方法 。 这 些 具有 特殊 用 途 的 方法 ,约定 的 命名 规则 如 下 : 


On < HTTP method>< handler name >[Async] 


此 命名 规则 随 着 ASP. NET Core 版 本 的 更 新 可 能 会 更 改 , 就 目前 版 本 而 言 ,方法 的 命名 包 
括 以 下 几 个 部 分 。 

(1) 方法 以 “On” 开 头 。 

(2) 紧 接着 是 HTTP-method, 例 如 GET、POST、DELETE 等 。 

(3) 然后 是 方法 的 “正式 名 称 ”, 此 名 称 可 以 直接 作为 路 由 参数 handler 的 值 。 

(4) 如 果 是 异步 方法 ,可 以 用 Async 结尾 (Async 是 可 选 的 ) 。 

以 下 命名 均 符合 约定 : 

OnGet 


OnPost 
OnGetStudentInfos 
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OnPostFileAsync 

OnDeletNickID 

当然 ,也 可 以 考虑 从 DefaultPageApplicationModelProvider 类 派生 出 一 个 自 定义 类 型 ， 
然后 重 写 相 关 的 方法 ,自行 定义 新 的 命名 约定 ,但 是 除非 有 特定 的 需求 ,一 般 没 有 必要 这 么 做 。 

页 面 模型 类 还 可 以 公开 属性 ,便于 与 视图 中 的 代码 进行 绑 定 。 由 于 HTTP 往返 通信 是 
无 状态 的 ,在 此 过 程 中 ,属性 的 值 通常 会 丢失 (客户 端 提交 页 面 后 ,页面 模型 类 中 的 属性 值 会 
丢失 )。 如 果 和 希望 页 面 模型 类 的 属性 在 HTTP 往返 通信 过 程 中 被 保留 ,可 以 在 属性 上 应 用 
BindPropertyAttribute, 格 式 如 下 。 


[BindProperty] 

public int Age { get; set; } 

在 Razor 页 面 上 可 以 通过 @model 指令 让 视图 与 页 面 模型 类 关联 起 来 ,格式 如 下 。 
(UsersModel 是 页 面 模型 类 ) 


@model UsersModel 


项 目 模板 在 添加 新 的 Razor 页 面 时 ,一 般 会 生成 一 个 与 页 面 名字 相 同 的 代码 文件 ,并 在 
这 个 代码 文件 中 定义 页 面 模型 类 。 例 如 ,添加 一 个 名 为 Users. cshtml 的 页 面 ,就 会 生成 一 
个 名 为 Users. cshtml. cs 的 代码 文件 ,里面 包含 一 个 从 PageModel 类 派生 的 子 类 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 中 新 建 一 个 目录 ,命名 为 Pages。 

步骤 3: 新 建 一 个 代码 文件 ,定义 一 个 类 ,命名 为 TestModel, 并 且 继承 PageModel 类 。 


public class TestModel : PageModel 


步骤 4: 定义 四 个 公共 属性 ,用 于 与 视图 进行 绑 定 。 


BindProperty] 

public string ProductName { get; set; } 
BindProperty] 

public DateTime ProductDate { get; set; } 
BindProperty] 

public Guid ProductID { get; set; } 
BindProperty] 

public string ProductFamily { get; set; } 


属性 中 一 般 会 应 用 BindProperty 特性 ,这 是 为 了 在 HTTP 往返 通信 的 过 程 中 保留 属性 
的 值 。 对 于 不 需要 保留 状态 的 属性 ,可 以 不 使 用 BindProperty 特性 。 
步骤 5: 定义 OnGet 方 法 , 当 以 HTTP-GET 方式 访问 页 面 时 会 调用 该 方法 ,同时 初始 
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化 四 个 属性 。 
public void OnGet() 
ProductID = Guid. NewGuid(); 
ProductName = "< 未 知 产品 >"; 
ProductDate = DateTime. Today; 
ProductFamily = "< 未 知 分 类 >"; 
步骤 6: 定义 OnPost 方法 , 当 页 面 提交 成 功 时 调用 。 


public void OnPost() 


ViewData[ "msg"] = "恭喜 你 ,提交 成 功 "; 


此 处 只 做 演示 ,所 以 处 理 比 较 简 单 ,仅仅 向 ViewData 字典 中 添加 了 一 个 子 项 ， 
ViewData 可 以 在 视图 与 模型 代码 之 间 共 享 数 据 。 
步骤 7: 新 建 一 个 . cshtml 文档 ,在 文档 顶部 输入 以 下 指令 : 


@page 

@using Demo 

@model TestModel 

@addTagHelper * ,Microsoft.AspNetCore.Mvc.TagHelpers 


@page 指令 标识 该 视图 用 于 Razor Page 应 用 程序 ; @using 导入 相关 的 命名 空间 ,与 C# 
语言 中 using 语句 的 作用 相同 ; @model 指令 用 于 设置 关联 的 模型 类 ,此 处 指定 的 是 刚刚 定 
义 的 TestModel 页 面 模型 类 ; @addTagHelper 指令 导入 HTTP 标记 帮助 器 ,用 以 扩充 
HTML 标签 的 功能 ,格式 为 “< 类 型 >,< 程 序 集 >”,< 类 型 > 也 可 以 用 星 号 ( * ) 表 示 , 即 导入 程 
序 集中 的 所 有 标记 帮助 器 类 型 。 

步骤 8: HTML 文档 内 容 如 下 。 


<!DOCTYPE html > 
<html> 
<head> 
<meta charset = "utf — 8" /> 
<title > 测试 页 面 </title> 
</head> 
<body> 
< form method = "post"> 
产品 编号 :< input type = "text" readonly asp - for = "ProductID"/>< br/> 
产品 名 称 :< input type= "text" asp— for = "ProductName"/>< br/> 
生产 日 期 :< input type = "text" asp- for = "ProductDate"/><br/> 
产品 分 类 :< input asp for = "ProductFamily"/>< br/> 
<br/><br/> 
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< input type= "submit" value= "提交 "/> 
</form> 
<div> 
@{ 
if (ViewData. ContainsKey("msg" ) ) 
<p>@ViewData[ "msg" ] .ToString()</p> 
} 


} 加 Wm 
</div> € 口 |o pmoss 回 让 | 多 | … 
en 产品 编号 : [7ca20dcb-adb5-435c-a0t 
产品 名 称 : | 新 产品 


asp-for 扩展 标记 用 于 将 HTML 元 素 与 页 面 模 | 生产 日 期 : [2018-8-7 
型 类 中 的 属性 绑 定 ;然后 显示 OnPost 方法 中 添加 | 产品 分 类 : | 辅 且 用 品 
到 ViewData 字典 中 的 内 容 。 

步骤 9: 运行 应 用 程序 ,在 浏览 器 页 面 上 输入 相 
关内 容 ,然后 单 击 “提交 ”按钮 。 由 于 模型 属性 使 用 | 恭喜 你 ， 提 交 成 功 
了 BindProperty 特性 ,所 以 提交 后 再 次 返回 页 面 > 
时 ,输入 的 内 容 会 被 保留 ,如 图 16-2 所 示 。 图 16-2 视图 与 页 面 模型 的 交互 


实例 349 ”Razor Page 应 用 的 路 由 映射 


【导语 】 

当 Razor Page 项 目的 URL 路 径 较 长 的 时 候 , 可 以 使 用 路 由 映射 来 缩短 URL。 举 个 例 
子 , 假 设 /Pages 目录 下 有 个 Accounts 目录 ,Accounts 目录 下 存在 页 面 CheckAll. cshtml , 按 
照 默 认 规则 ,要 访问 该 页 面 其 URL 应 为 http: //demo. org/Accounts/CheckAll, 但 是 经 过 
路 由 映射 后 ,其 URL 可 以 简化 为 http: //demo. org/checks。 

本 实例 将 在 /Pages 目录 下 创建 子 目 录 Users, 再 在 Users 目录 下 创建 两 个 页 面 -一 
NewUser 与 UserList, 默 认 情 况 下 ,这 两 个 页 面 的 URL 路 径 分 别 为 /Users/NewUser 和 
/Users/UserList, 经 过 路 由 映射 后 ,会 简化 为 /regnew 和 /showlist。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 中 新 建 目录 Pages。 

步骤 3: 在 Pages 目录 下 新 建 页 面 Start. cshtml, 其 中 HTML 内 容 如 下 。 


@page 


<!DOCTYPE htm] > 
< html > 
< head> 
<meta charset = "utf 一 8" /> 
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<title> 主 页 </title> 
</head> 
<body> 
<div> 
<h2> 主 页 </h2> 
< h4 > 阳光 驿站 </h4 > 
</div> 
<hr/> 
<div> 
<a href = "/regnew"> 注 册 新 用 户 </a> 
<a href = "/showlist"> 查 看 用 户 列表 </a> 
</div> 
</body> 
</html > 


页 面 中 有 两 个 超 链 接 , 它 们 所 指向 的 路 径 是 经 过 路 由 映射 后 的 路 径 。 
步骤 4: 在 Pages 目录 下 新 建 一 个 子 目录 ,命名 为 Users。 
步骤 5: 在 Users 目录 下 新 建 页 面 NewUser. cshtml。 


@page 


<! DOCTYPE html > 
<html> 
<head> 
<meta charset = "utf ~ 8" /> 
<title > 注册 </title> 
</head> 
<body> 
<div> 
<p> 
< hl > 新 用 户 注册 </hi > 
</p> 
<div> 
增加 一 个 新 的 用 户 
</div> 
</div> 
</body> 
</html > 


步骤 6: 在 Users 目录 下 新 建 一 个 页 面 ,命名 为 UserList. cshtml。 
@page 


<! DOCTYPE htm] > 
<html> 
<head> 

<meta charset = "utf -8" /> 
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<title> 用 户 列表 </title> 
</head> 
<body> 
<div> 
<table> 
<thead> 
<te> 
<th> 用 户 名 </th> 
<th>ID</th> 
</tr> 
</thead> 
<tbody> 
@! 
for(int i = 1; i<= 10; i++) 
<tr> 
<td>@string. Format(" 用 户 {0}"，i)</td> 
<td>@i</td> 
</tr> 


} 
} 
</tbody > 
</table> 
</div> 
</body> 
</html > 


为 了 演示 ,页 面 中 通过 for 循环 产生 10 条 用 户 记 录 。 


步骤 7: 在 Starup. ConfigureServices 方法 中 注册 与 MVC 相关 的 服务 ,并 且 添 加 路 由 
映射 配置 。 


services. AddMvc( ). AddRazorPagesOptions(o => 
{ 
9. Conventions 
.AddPageRoute("/Start", "/") 
. AddPageRoute("/Users/NewUser", "/regnew") 
.AddPageRoute("/Users/UserList", "/showlist"); 
DD); 


AddPageRoute 方法 的 第 一 个 参数 是 真实 的 页 面 地 址 ,第 二 个 参数 是 路 由 之 后 的 新 地 
址 。 如 果 将 某 个 页 面 的 URL 路 由 映射 为 “/” 或 者 空 字符 串 , 就 可 以 使 该 页 面 变 成 主页 , 即 
在 浏览 器 地 址 栏 中 直接 输入 Web 站 点 的 根 地 址 就 能 定位 到 该 页 面 。 例 如 在 上 面 代码 的 配 
置 中 ,如 果 在 浏览 器 地 址 栏 中 输入 http: //localhost, 实 际 上 会 执行 http: //localhost/Start 


页 面 ; 如 果 输 入 http: //localhost/regnew ,实际 是 执行 了 http: //localhost/users/newuser 
页 面 。 
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实例 350 ”通过 @page 指令 设置 Razor 页 面 的 URL 路 由 


【导语 】 

本 实例 将 演示 一 种 更 简单 的 方法 来 设置 Razor Page 应 用 的 URL 路 由 映射 一 一 使 用 页 
面 视图 的 @page 指令 。 在 @page 指令 之 后 ,可 以 使 用 字符 串 实例 来 指定 路 由 映射 ,该 路 由 
使 用 的 是 相对 路 径 , 可 以 分 为 两 种 情况 : 

(1) 直接 指定 路 径 段 ,表示 该 路 由 是 相对 于 当前 页 面 的 。 例 如 ,指定 字符 串 “renew”, 当 
前 页 面 名 为 Orders ,那么 最 终 访 问 该 页 面 的 URL 为 http: //demo. net/orders/renew。 

(2) 如 果 指 定 的 字符 是 以 */? 或 者 “一 人" 开头 , 则 表示 其 路 由 是 相对 于 根 URL 的 。 例 
如 ,页 面 /users/admin, 而 指定 的 路 由 为 */admin”, 那 么 访问 该 页 面 的 URL 应 为 http: 
//demo. net/yadmin 。 

本 实例 将 对 三 个 页 面 进 行路 由 映射 , 详 见 表 16-1。 

表 16-1 实例 路 由 映射 方案 


映 射 前 映 射 后 
/Main / 
/Funcs/MyMusics /musics 
/Funcs/MyPhotos /Photos 
【操作 流程 】 


步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 在 项 目 中 新 建 一 个 目录 ,命名 为 Pages。 
步骤 3: 在 Pages 目录 下 添加 一 个 Main. cshtml 页 面 。 


@page "/" 


<html> 
<body> 
< h2 > 主页 </h2 > 
<div> 
<a href = "/musics"> 我 的 音乐 </a> 
<a href = "/photos"> 我 的 照片 </a> 
</div> 
</body> 
</html > 


在 @page 指令 后 面 的 字符 串 中 指定 “/”, 表 明 从 根 URL 就 可 以 访问 该 页 面 。 
步骤 4: 在 Pages 目录 下 创建 一 个 子 目录 ,名 为 Funcs。 
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步骤 5$: 在 Funcs 目录 下 添加 一 个 MyMusics. cshtml 页 面 。 


@page "/musics" 


<html> 
<body> 
< h2 > 我 的 音乐 </h2 > 
</body> 
</html > 


步骤 6: 在 Funcs 目录 下 添加 一 个 MyPhotos. cshtml。 


@page "/photos" 


< html > 
<body> 
< h2 > 我 的 照片 </h2 > 
</body> 
</html > 


运行 应 用 程序 后 ,输入 根 URL 打开 Main 页 面 (如 图 16-3 所 示 ) , 单 击 页 面 上 的 链接 ,可 
以 跳 转 到 其 他 页 面 (如 图 16-4 所 示 ) 。 


ocx el 
| 人口。 eesozspeel| 隐 
< OO opmahox 门 广 芭 

我 的 照片 
主页 
我 的 音乐 我 的 照片 
图 16-3 根 URL 下 的 页 面 图 16-4 跳 转 到 /photos 页 面 
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【导语 】 

在 页 面 模型 (从 PageModel 类 派生 的 类 ) 中 ,OnGet、OnPost、OnPut 等 方法 会 根据 页 面 
的 请 求 方法 自动 被 调用 。 例如 以 HTTP-GET 方法 访问 页 面 就 会 调用 OnGet 或 者 
OnGetAsync 方 法 ,以 HTTP-POST 方法 访问 页 面 就 会 调用 OnPost 或 者 OnPostAsync 方法 。 

但 是 这 些 约定 方 法 有 时 是 不 能 满足 开发 需求 的 ,因此 框架 允许 自 定义 这 些 方 法 的 名 称 ， 
在 路 由 数据 字典 中 ,这 些 页 面 方法 被 命名 为 handler。 上 默认 情况 下 是 通过 URL 的 请 求 参数 
来 调用 页 面 方法 的 ,例如 http: //localhost/students? handler 王 UploadPic, 其 中 ,students 
是 页 面 名称 ,UploadPic 是 页 面 模型 中 的 方法 名 ,实际 的 方法 命名 应 该 为 OnGetUploadPic。 
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如 果 不 希 望 在 URL 


Ph 出 现 handler 字段 ,可 以 通过 @page 指令 来 自 定义 路 由 ,例如 : 


@page "{handler?}" 


handler 是 路 由 字典 参数 ,必须 写 在 一 对 大 括号 中 ,后 面 的 问号 表示 该 值 为 可 选 ,通过 自 定 义 


路 由 后 ,指定 handler 


的 URL 可 变 为 http: //localhost/students/UploadPic。 


在 页 面 模型 中 自 定 义 handler 方法 的 命名 规则 如 下 : 
On< HTTP - method >< handler name >[Async] 


方法 以 On 开头 ,On 之 后 是 HTTP 请 求 方法 ,例如 Get、Post 等 ,HTTP 请 求 方法 之 后 才 是 
handler 的 名 称 ,Async 后 级 是 可 选 的 ,以 下 命名 都 是 允许 的 。 


OnGetOrder // handler 名 为 Order, 以 HTTP - GET 方法 访问 
OnPostFeedbackAsync // handler 名 为 Feedback, 以 HTTP - POST 方法 访问 ,异步 方法 
OnGetOrderAsync // handler 名 为 Order, 异步 方法 

OnDeleteItem // handler 名 为 Item, 以 HTTP - DELETE 方法 访问 
OnGetColors // handler 名 为 Colors, 以 HTTP - GET 方法 访问 


在 实际 使 用 时 ,如 果 需 要 调用 目标 handler, 可 以 使 用 扩展 的 标记 帮助 器 在 运行 时 自动 
生成 URL, 例 如 ,asp-page 标记 属性 指定 要 执行 的 页 面 ,当前 页 面 可 以 忽略 ; asp-page- 
handler 标记 属性 指定 要 执行 的 handler 的 名 称 。 


【操作 流程 】 


步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 在 项 目 中 新 建 Pages 目录 。 

步骤 3: 在 Pages 目录 下 面 添 加 test. cshtml 页 。 

步骤 4: 在 test 页 面 项 部 ,添加 以 下 指令 声明 。 

@page "{handler?}" 


@addTagHelper * ,Microsoft.AspNetCore.Mvc.TagHelpers 
@model Demo. TestModel 


@page 指令 设置 


查找 handler 的 路 由 ,@addTagHelper 指令 用 于 导入 HTML 标记 扩 


展 帮 助 器 类 型 ,本 实例 中 将 导入 Microsoft. AspNetCore. Mvc. TagHelpers 程序 集中 的 所 有 


帮助 器 ,@model 指令 


设置 与 页 面 关联 的 模型 类 ,用 于 定义 页 面 处 理 方法 。 


步骤 5: test 页 面 的 HTML 文档 如 下 。 


<html> 
<body> 


< form method = "post"> 
用 户 名 : 
< input type = "text" name = "username" /><br /> 
密码 : 


< input type = "password" name = "password"/>< br/> 


< div 


> 
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< input type = "submit" value = "公开 登录 "asp- page -handler = "LoginPublic"/> 
< input type = "submit" value = "隐身 登录 " asp 一 page 一 handler = "LoginHidden"/> 
</div> 
</form> 
</body > 
</html > 
在 两 个 提交 按钮 上 ,通过 asp-page-handler 标记 属性 来 指定 要 调用 的 方法 ,由 于 处 理 的 
方法 将 在 当前 页 面 的 模型 类 中 定义 ,所 以 不 需要 使 用 asp-page 标记 属性 。 在 form 标记 中 ， 
需要 为 两 个 文本 的 输入 元 素 设置 name 值 ,这 样 当 提 交 页 面 时 会 自动 将 用 户 输入 的 内 容 传 
递 给 页 面 模型 中 处 理 方法 的 参数 ,前 提 是 HTML 元 素 的 name 值 必须 与 方法 参数 的 名 称 匹配 。 
步骤 6: 定义 页 面 模型 类 ,以 及 两 个 handler 方法。 


public class TestModel : PageModel 
{ 
public ActionResult OnPostLoginPublic( string username, string password) 
{ 
string msg = $ "你 以 公共 方式 登录 ,输入 的 用 户 名 为 {username} ,密码 为 {password}"; 
return Content (msg); 


} 


public ActionResult OnPostLoginHidden( string username, string password) 
{ 
string msg = $ "你 以 隐身 方式 登录 ,输入 的 用 户 名 为 {username} ,密码 为 {password}"; 


return Content (msg); 


k 
方法 参数 的 名 字 要 与 页 面 视图 上 < input > 元 素 的 name 值 相 同 ,才能 传递 内 容 , 即 分 别 


为 username 和 password 。 


注意 : 调用 两 个 handler 方法 后 均 返回 HTML 文本 。 在 实际 开发 中 ,不 可 能 将 用 户 输入 的 
密码 以 明文 的 方式 展现 ,此 处 仅仅 是 演示 。 


步骤 7: 运行 应 用 程序 , 先 输入 用 户 名 和 密码 ,然后 可 以 分 别 单 击 两 个 按钮 提交 ,如 
图 16-5 和 图 16-6 所 示 。 


加 localhost 


€ SO © localhost9100/te: 去 区 | a 


你 以 隐身 方式 登录 ， 输 入 的 用 户 名 为 admin， 密 码 为 12345 


图 16-5 输入 用 户 名 和 密码 图 16-6 提交 后 的 处 理 结果 
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浏览 器 打开 test 页 面 后 ,其 产生 的 两 个 提交 按钮 的 HTML 标签 如 下 : 


< input type = "submit" value = "公开 登录 " formaction = "/test/LoginPublic" /> 
< input type = "submit" value = "隐身 登录 " formaction = "/test/LoginHidden" /> 


formaction 属性 中 的 内 容 就 包含 相应 的 handler 名 称 。 
16.2 MVC( 模 型 -框架 -视图 ) 


实例 352 ”为 全 局 路 由 字段 分 配 默认 值 


【导语 】 

MVC 应 用 程序 的 URL 路 由 有 两 种 定义 方式 : 四 在 Startup. Configure 方法 中 通过 
UseMvc 方法 设置 的 路 由 规则 会 应 用 到 整个 应 用 程序 中 ; @ 在 每 个 控制 器 类 以 及 其 成 员 方 
法 上 通过 Route 特性 设置 的 路 由 为 局 部 规则 , 仅 对 当前 控制 器 有 效 。 

URL 路 由 以 字符 串 的 形式 表示 ,其 中 有 三 个 占 位 符 , 它 们 属于 路 由 字典 中 的 Key, 因 此 
这 三 个 值 比较 特殊 ,需要 写 在 一 对 大 括号 中 ,三 个 占 位 符 如 下 。 

(1) {area) : 表示 MVC 应 用 程序 中 的 “ 域 ”, 通 常用 于 划分 程序 功能 ,小 型 项 目 可 以 不 
使 用 。 

(2) {controller} : 表示 控制 器 的 名 称 。 如 果 控 制 器 类 的 名 称 带 有 “Controller” 后 级 , 则 

后 级 会 被 去 掉 。 例 如 , 某 控制 器 类 命名 为 PublishController, 那么 在 使 用 URL 时 ， 
controller 字段 的 值 应 该 为 Publish。 

(3) {action) : 控制 器 类 中 的 要 执行 的 方法 名 称 。 

此 外 ,还 可 以 自 定义 参数 名 ,例如 : 


{controller}/{action} /{id?} 


其 中 ,id 是 传递 给 某 个 action 方法 的 参数 的 名 称 , 假 设 要 调用 Publish 控制 器 中 的 Review 
方法 ,参数 id 为 105 ,那么 请 求 的 URL 应 为 http: //localhost/publish/review/105。{id}) 中 
的 问号 (?) 表 示 该 字段 是 可 选 的 ,如 果 不 需要 提供 参数 值 ,那么 请 求 的 URL 就 是 http: // 
localhost/publish/review。 

但 在 实际 开发 中 ,一 般 不 应 该 让 用 户 记 住 这 么 长 的 URL, 对 于 应 用 程序 主页 ,只 要 在 浏 
览 器 地 址 栏 中 输入 根 URL 就 能 访问 默认 页 面 ,因此 MVC 框架 允许 为 URL 路 由 中 的 字段 
值 分 配 默 认 值 ,例如 : 


{controller = Home}/{action = Index} 


当 用 户 输入 http: //someweb. com 时 ,实际 上 就 执行 了 Home 控制 器 中 的 Index 方法 , 即 
http: //someweb. com/ Home/Index。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 


第 16 章 “MVC 与 Web AP| | 467 


步骤 2: 在 Startup. ConfigureServices 方法 中 调用 AddMvc 添加 相关 的 服务 。 
services. RddMvc( ); 
步骤 3: 在 Startup. Configure 方法 中 使 用 MVC 相关 的 中 间 件 。 


app. UseMvc(r => 
{ 
r. MapRoute( "main", "{controller = Demo}/{action = Default}"); 

}); 

在 调用 UseMvc 方法 时 ,可 以 通过 委托 设置 URL 路 由 ,MapRoute 方法 需要 为 路 由 规 
则 分 配 一 个 名 称 , 该 名 称 可 以 自 定义 ,主要 用 来 唯一 标识 本 路 由 规则 。 在 本 实例 中 , 设 定 的 
默认 控制 器 名 为 Demo ,默认 的 执行 方法 名 为 Default。 

步骤 4: 在 项 目 中 添加 一 个 类 ,命名 为 DemoController(Controller 后 级 是 可 选 的 ,属于 
命名 约定 ) ,并 且 该 类 从 Controller 类 派生 ,表示 一 个 控制 器 。 

public class DemoController : Controller 

{ 


public ActionResult Default() 
{ 


return Content(" 这 是 一 个 Web 应 用 "); 
} 
} 
Default 即 Action 方法 , 它 返回 一 个 字符 串 内 容 。 
步骤 5: 运行 应 用 程序 ,直接 输入 根 URL, 就 能 访问 到 Demo 控制 器 了 ,例如 http: // 
localhost: 7603 。 


实例 3$3 ”局 部 的 URL 路 由 


【导语 】 

在 Startup. Configure 方法 中 定义 的 路 由 规则 是 全 局 的 ,适用 于 整个 应 用 程序 。 但 有 时 
对 于 部 分 控制 器 ,开发 者 需要 使 用 特殊 的 路 由 规则 , 即 局 部 的 URL 路 由 ,主要 是 通过 在 控 
制 器 类 或 者 控制 器 类 的 方法 成 员 上 附加 Route 特性 (RouteAttribute 类 ) 来 实现 的 。 局 部 路 
由 规则 仅 在 Route 特性 所 应 用 的 目标 对 象 上 有 效 , 它 的 优先 级 高 于 全 局 路 由 规则 。 

在 全 局 路 由 规则 中 ,controller、action 等 特殊 字段 是 在 一 对 大 括号 中 的 ,但 在 局 部 路 由 
规则 中 ,使 用 的 是 中 括号 ,例如 以 下 形式 。 


[controller]/[action] 
但 是 ,参数 名 称 依然 要 使 用 大 括号 括 起 来 ,例如 : 
[controller]/[action]/{id?} 


其 中 ,id 是 参数 ,问号 表示 该 值 是 可 选 的 。 
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局 部 路 由 也 可 以 使 用 “ 硬 编码 ”的 URL, 即 不 使 用 controller、action 等 占 位 符 ,而 是 指定 
固定 的 URL 路 径 ,例如 : 

/users 
此 时 ,不 管 目标 控制 器 叫 什么 名 称 , 只 要 使 用 http: //abc. org/users 就 能 访问 该 控制 器 。 

同时 ,Route 特性 也 支持 URL 的 “分 层 " 组 合 。 假 设 在 某 控制 器 上 应 用 了 路 由 规则 
/students, 然 后 在 控制 器 类 的 某 个 方法 上 应 用 路 由 规则 getinfo, 那 么 完整 的 URL 就 变 成 
http: //abc. org/students/getinfo。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup. ConfigureServices 方法 中 注册 与 MVC 功能 有 关 的 服务 。 


public void ConfigureServices(IServiceCollection services) 


services. AddMvc( ); 


步骤 3: 在 Startup. Configure 方 法 中 使 用 MVC 中 间 件 。 
public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
app. UseMvc( ); 


本 实例 将 使 用 局 部 路 由 规则 ,因此 在 调用 UseMvc 方法 时 不 需要 定义 路 由 规则 。 
步骤 4: 定义 第 一 个 控制 器 ,命名 为 Main, 包 含 两 个 操作 方法 。 


Route("[controller]/[action]")] 
public class MainController : Controller 


public ActionResult About() 
{ 

return Content(" 关 于 本 站 "); 
} 


public ActionResult Home() 
{ 
return Content ("官方 主页 "); 


} 


访问 该 控制 器 时 ,会 用 控制 器 的 名 称 蔡 换 URL 路 由 规则 中 的 [controller] 与 Laction] 。 
步骤 5: 定义 第 二 个 控制 器 Product, 它 将 使 用 不 带 占 位 符 的 URL ,并 且 Route 特性 将 
分 别 应 用 到 类 和 操作 方法 上 。 
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[Route("/products")] 
public class ProductController : Controller 
{ 

[Route("list")] 

public ActionResult GetList() 

{ 

return Content ("产品 列表 "); 

} 
. 
访问 GetList 方法 的 URL 是 固定 的 , 即 http: //localhost/products/list。 
步骤 6: 运行 应 用 程序 ,可 通过 以 下 几 个 URL 来 做 访问 测试 。 
http://localhost:17120/main/about 


http://localhost:17120/main/home 
http://localhost:17120/products/list 


实例 354 自 定 义 视图 文件 的 查找 位 置 


【导语 】 

在 MVC 的 控制 器 中 调用 不 带 参 数 的 View 方法 时 ,将 返回 与 Action 名 称 相同 的 视图 。 
框架 查找 视图 文件 的 默认 路 径 有 以 下 三 个 : 

/Views/{1}/{0}.cshtml 

/Views/Shared/{0}.cshtml 

/Pages/Shared/{0}.cshtml 
路 径 中 包含 字符 串 的 格式 占 位 符 , (1) 表示 Controller 的 名 称 ,{0} 表 示 Action 的 名 称 。 假 
设 访问 Goods 控制 器 中 的 Reset 方法 ,那么 在 返回 视图 时 ,MVC 框架 将 查找 如 下 文件 。 


/Views/Goods/Reset. cshtm] 


Shared 目录 下 的 视图 一 般 用 于 布局 页 (页 面 的 母 版 ) 或 者 可 以 在 多 个 控制 器 中 共用 的 
视图 (例如 显示 错误 信息 的 页 面 ) 。 

对 于 带 有 Area 的 MVC 项 目 , 其 视图 查找 路 径 为 : 

/areas/{2}/Views/{1}/{0}.cshtml 

/Areas/{2}/Views/Shared/{0}.cshtml 

/Views/Shared/{0}.cshtml 

/Pages/Shared/{0}.cshtml 
此 处 的 {2} 是 Area 的 占 位 符 ,{1} 是 Controller 的 占 位 符 ,{0} 是 Action 的 占 位 符 。 

RazorViewEngineOptions 类 公开 的 AreaViewLocationFormats 属性 和 ViewLocationFormats 
属性 都 是 用 于 配置 视图 文件 的 查找 路 径 的 ,它们 均 为 字符 串 列表 ,可 以 添加 多 个 查找 路 径 。 
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本 实例 将 演示 将 视图 文件 的 查找 目录 从 Views 改 为 DemoViews。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup. ConfigureServices 方法 中 添加 与 MVC 相关 的 服务 ,并 且 调 用 
AddRazorOptions 方法 配置 视图 查找 路 径 。 


services. AddMvc( ). AddRazorOptions(o => 
{ 

// 清除 默认 路 径 

o. ViewLocationFormats. Clear( ); 

// 添加 自 定义 的 路 径 

o. ViewLocationFormats. Add("/DemoViews/{1}/{0}" + RazorViewEngine. ViewExtension) 

o. ViewLocationFormats. Add("/DemoViews/Shared/{0}" + RazorViewEngine. ViewExtension) ; 
])， 


RazorViewEngine. ViewExtension 字段 能 自动 返回 视图 文件 的 扩展 名 。 
步骤 3: 在 Startup. Configure 方 法 中 使 用 与 MVC 相关 的 中 间 件 。 


app. UseMvc() 
步骤 4: 定义 控制 器 类 ,此 类 包含 两 个 操作 方法 一 一 Testl 和 Test2。 


[Route("[controller]/[action]")] 
public class SampleController : Controller 
{ 
public IActionResult Test1() => View(); 
public IActionResult Test2() => View(); 
} 


步骤 $: 在 项 目 中 创建 DemoViews 目录 ,再 在 DemoViews 目录 下 创建 Sample 目录 
(与 控制 器 名 称 相同 )。 

步骤 6: 在 Sample 目录 下 添加 两 个 . cshtml 文件 ,命名 都 与 Sample 控制 器 的 两 个 操作 
方法 匹配 一 一 Testl. cshtml 和 Test2. cshtml。 


// Test1. cshtml 
<html> 
<body> 
<div> 
<h2 > 视图 1 </h2 > 
</div> 
</body> 
</html > 


// Test2. cshtml 
< html > 
< body> 
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<div> 
<h2 > 视图 2</h2> 

</div> 
</body> 
</html > 
步骤 7: 运行 应 用 程序 ,分 别 使 用 以 下 URL 可 以 访问 到 Sample 控制 器 的 两 个 操作 

方法 。 

http://localhost:1909/sample/test1 
http://localhost:1909/sample/test2 


实例 355 根据 URL 查询 参数 返回 不 同 的 视图 


【导语 】 

控制 器 的 View 方法 有 以 下 几 种 方法 返回 视图 : 

(1) 无 参数 调用 。 这 种 情况 下 ,视图 文件 的 名 称 必须 与 当前 操作 方法 的 名 称 相同 , 即 
Action 的 名 称 与 视图 文件 名 一 致 。 

(2) 指定 视图 名 称 ( 不 包含 路 径 与 文件 扩展 名 ) 。 如 果 视 图 文件 位 于 以 当前 控制 器 命名 
的 目录 下 ,那么 指定 视图 名 称 时 不 需要 指定 文件 扩展 名 。 例 如 ,视图 文件 名 为 
OrderDetails. cshtml, 那 么 只 要 指定 OrderDetails 就 能 找到 该 视图 。 

(3) 包含 路 径 与 文件 扩展 名 。 当 视图 文件 不 位 于 以 当前 控制 器 命名 的 目录 下 ,或 者 不 
在 设 定 的 查找 路 径 内 , 则 需要 指定 视图 文件 的 完整 路 径 , 例如 一 /Views/Something. 
cshtml。 

本 实例 将 演示 通过 URL 的 查询 参数 判定 应 该 返回 哪个 视图 。 实 例 中 将 用 到 三 个 视图 
文件 ,Default. cshtml 文件 位 于 /Views 目录 下 ,Preview. cshtml 和 Pagedview. cshtml 两 个 
文件 均 位 于 与 Demo 控制 器 同名 的 目录 下 。 如 果 请 求 参 数 mode 的 值 为 preview, 则 使 用 
Preview. cshtml 视图 文件 ; 如 果 参 数 mode 的 值 为 pagedview, 则 使 用 Pagedview. cshtml 视 
图 文件 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup. ConfigureServices 方法 中 注册 与 MVC 相关 的 服务 。 


services. AddMvc( ); 


步骤 3: 在 Startup. Configure 方法 中 使 用 与 MVC 相关 的 中 间 件 。 


app. UseMvc(route => 
{ 

route. MapRoute("app", "{controller}/{action}"); 
DD); 
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步骤 4: 在 项 目 中 新 建 Views 目录 。 
步骤 5: 在 Views 目录 下 添加 一 个 名 为 Default. cshtml 的 视图 文件 。 


<html> 
<body> 
< hl > 默认 视图 </hl > 
</body> 
</html > 


步骤 6: 在 Views 目录 下 新 建 一 个 目录 ,命名 为 Demo( 与 控制 器 名 称 一 致 ) 。 
步骤 7: 在 Demo 目录 下 添加 两 个 视图 文件 。 


// Preview. cshtml 
<html> 
<body> 

< hl > 预览 视图 </hl > 
</body> 
</html > 


// Pagedview. cshtml 
<html> 
<body> 

< hl > 分 页 视图 </hl > 
</body> 
</html > 


步骤 8: 定义 控制 器 类 。 


public class DemoController : Controller 


{ 
public ActionResult GetInfo( [FromQuery]string mode) 
{ 
if(mode == "preview") 
‘ 
return View("Preview" ); 
} 
else if(mode == "pagedview") 
{ 
return View("Pagedview" ); 
} 
return View("~ /Views/Default. cshtm]"); 


} 


mode 参数 的 值 将 从 URL 查询 参数 (在 URL 中 以 问号 开头 的 部 分 ) 中 提取 ,所 以 在 声 
明 参 数 时 要 加 上 FromQuery 特性 ,否则 无 法 提取 。 
Preview 视图 与 Pagedview 视图 都 位 于 与 控制 器 同名 的 目录 中 ,因此 调用 View 方法 时 
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不 需要 指定 路 径 与 扩展 名 ; 但 Default 视图 需要 明确 文件 路 径 。 
步骤 9: 运行 应 用 程序 ,可 以 在 浏览 器 中 尝试 用 | 昌 oanos x 压 re 
以 下 地 址 进行 访问 。 € © “| emofgetinformode=previeud 


http://localhost:9105/demo/getinfo?mode = preview 


1 z 刁 
http://localhost:9105/demo/getinfo?mode = pagedview 预览 


http://localhost:9105/demo/getinfo?mode = 
http://localhost:9105/demo/getinfo 


效果 如 图 16-7 所 示 。 


实例 356 ” 自 定 义 的 控制 器 类 


【导语 】 

定义 控制 器 ,不 仅 可 以 继承 Controller 类 ,还 可 以 自 定义 一 个 类 ,然后 将 其 作为 控制 器 。 
方法 是 在 类 声明 上 应 用 Controller 特性 (ControllerAttribute 类 ) ,然后 该 类 所 公开 的 公共 方 
法 将 被 视 为 操作 方法 ( 即 Action) 。 

本 实例 将 演示 一 个 简单 的 MVC 应 用 程序 ,使 用 一 个 独立 的 自 定 义 类 作为 控制 器 ,并 在 
操作 方法 上 返回 视图 (方法 返回 的 实际 类 型 为 ViewResult) 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 类 中 ,分 别 配 置 与 MVC 相关 的 服务 组 件 和 中 间 件 。 


图 16-7 根据 URL 参数 筛选 视图 


public void ConfigureServices(IServiceCollection services) 
{ 


services. AddMvc( ); 


: 


public void Configure(IRpplicationBuilder app) 
{ 
app. UseMvcWithDefaultRoute( ); 


} 

UseMvcWithDefaultRoute 方法 的 作用 与 UseMvc 方法 一 样 ,只 是 它 会 添加 默认 的 路 
规则 , 即 {controller 二 Home)/{action 二 Index}/{id?})。 

步骤 3: 自 定义 一 个 类 ,命名 为 MyController, 即 控制 器 为 My。 


[Controller] 
public class MyController 
{ 
public ActionResult Index() 
{ 
ViewResult res = new ViewResult 


{ 
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ViewName = "Default" 
}; 


return res; 


注意 ; 若 将 未 从 Controller 类 派生 的 类 作为 控制 器 使 用 ,必须 应 用 ControllerAttribute。 
由 于 自 定义 的 类 中 没有 View 方法 ,因此 在 操作 方法 中 需要 手动 创建 ViewResult 实 
例 ,并 为 ViewName 属性 赋值 。 


步骤 4: 在 项 目 中 新 建 Views 目录 。 
步骤 5: 在 Views 目录 下 创建 My 子 目录 (与 控制 器 同名 ) 。 


步骤 6: 在 My 目录 下 添加 视图 文件 Default. 
Ri Do > 四 
CS o 
Cy O localhos 丫 友 [3 | 
<html> 
<body> rn 
< hl > 欢迎 访问 本 站 </hl > 欢迎 访问 本 站 
< hr/> 
< h4 > 一 一 RSP.NET Core Web Dev </h4 > 
</body> 一 一 ASP.NET Core Web Dev 
</html > 


步骤 7: 运行 应 用 程序 ,在 浏览 器 中 访问 
http: //localhost/my/index, 可 以 看 到 如 图 16-8 


图 16-8 自 定义 控制 器 类 返回 的 视图 


所 示 的 结果 。 
实例 357 阻止 控制 器 中 的 方法 被 公开 为 Action 方法 
【导语 】 


在 控制 器 类 中 ,默认 会 将 所 有 公共 方法 视 为 操作 方法 (MVC 中 的 Action) ,但 在 某 些 特 
殊 情况 下 ,不 希望 某 些 方法 被 作为 Action 方法 公开 。 在 方法 上 应 用 NonAction 特性 之 后 ， 
该 方法 将 被 禁止 作为 Action 方法 公开 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 类 中 ,注册 MVC 服务 并 启用 中 间 件 。 

public void ConfigureServices(IServiceCollection services) 

{ 


Services. AddMvc( ); 


} 


public void Configure( IApplicationBuilder app) 
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{ 
app. UseMvcWithDefaultRoute( ); 
} 


步骤 3: 定义 控制 器 类 ,类 中 包含 两 个 方法 ,其 中 SayHello 方法 将 被 禁止 作为 Action 
方法 公开 。 
public class HomeController : Controller 


{ 
public IActionResult Index() 


{ 


return View(); 


} 


[NonAction] 
public string SayHello() 
return "你 好 ,世界 "; 
} 
} 
步骤 4: 当 运 行 应 用 程序 时 ,访问 http: //localhost/home/sayhello 将 返回 404 错误 ,这 
表明 SayHello 方法 已 被 禁止 公开 ,无 法 通过 URL 访问 ; 一 旦 去 掉 NonAction 特性 ， 
SayHello 方法 就 能 够 顺利 访问 。 


实例 358” 重 命名 Action 方法 


【导语 】 

MVC 框架 默认 指定 Action 方法 的 名 称 与 成 员 方 法 的 名 称 一 致 ,但 是 如 果 控 制 器 类 的 
成 员 方 法 上 应 用 了 ActionName 特性 (ActionNameAttribute 类 ) 并 指定 了 另 一 个 名 称 ,那么 
Action 方法 的 名 称 将 不 再 与 成 员 方法 名 称 相 同 。 如 果 Action 方法 被 重 命名 了 ,与 Action 
方法 相对 应 的 视图 文件 也 要 使 用 ActionName 特性 所 指定 的 名 称 ,而 不 是 成 员 方法 的 名 称 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 方法 中 注册 与 MVC 相关 的 服务 ,并 启用 中 间 件 。 

public void ConfigureServices(IServiceCollection services) 


{ 


services. AddMvc( ); 


} 


public void Configure( IApplicationBuilder app) 
{ 

app. UseMvcWithDefaultRoute( ); 
} 
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步骤 3: 定义 控制 器 ,类 名 为 Home, 其 中 包含 成 员 方法 GetItems。 


public class HomeController : Controller 
{ 

[ActionName("get — items")] 

public ActionResult GetItems() 

{ 

return View(); 

} 

: 


Action 的 实际 名 称 已 变 为 get-items, 而 不 是 GetItems, 所 以 请 求 的 URL 应 为 http: // 
somehost/home/ getritems 。 

步骤 4: 在 项 目 中 新 建 Views 目录 。 

步骤 5: 在 Views 目录 中 新 建 Home 子 目录 。 

步骤 6: 在 Home 目录 中 添加 视图 文件 ,文件 名 为 get-items. cshtml。 


for (inta = 1;a<5; af++) 
{ 
<1i>@string. Format(" 项 目 {0}"，a)</1i> 
} 
</ul> 
</body> 
</html > 


注意 : 视图 的 名 称 不 能 再 使 用 GetItems 了 ,因为 Action 已 经 被 重 命名 了 。 


步骤 7: 运行 应 用 程序 ,在 浏览 器 中 访问 http: //localhost: 4800/home/get-items, 结 
果 如 图 16-9 所 示 。 


日 oem x 革 Se 


> © alhost4800/home/get-itemd 


* 项 目 1 
*。 项目 2 
， 项 目 3 
*。 项 目 4 


图 16-9 访问 重 命名 后 的 Action 方法 
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实例 359 ”使 用 布局 页 


【导语 】 

布局 页 可 作为 项 目 内 各 视图 的 母 版 ,用 于 排版 被 重复 使 用 的 内 容 , 例 如 版 权 信息 、 网 站 
Logo、 导 航 栏 等 。 使 用 布局 页 的 优点 是 可 以 避免 大 量 重复 性 的 工作 。 

在 布局 页 视图 文件 中 ,可 以 在 内 容 页 出 现 的 位 置 调用 RenderBody 方法 来 生成 占 位 符 ， 
当 某 个 内 容 页 应 用 了 当前 布局 页 后 ,内容 页 的 HTML 元 素 将 出 现在 调用 RenderBody 方法 
的 地 方 。 

在 内 容 视图 文件 中 ,通过 Layout 属性 (在 RazorPageBase 类 中 公开 ) 可 以 设置 布局 页 的 
名 称 。 如 果 布 局 页 位 于 可 以 被 查找 到 的 位 置 (例如 /Views/Shared 目录 下 ) ,那么 是 不 需要 
指定 路 径 和 扩展 名 ; 否则 就 要 明确 指定 布局 页 的 文件 路 径 和 扩展 名 ,这 与 视图 文件 的 查找 
方式 相似 。 一 般 在 命名 有 特殊 用 途 的 视图 文件 时 都 会 以 下 画 线 开头 ,所 以 布局 页 通常 命名 
为 _Layout. cshtml。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 目录 下 新 建 一 个 Views 目录 。 

步骤 3: 在 Views 目录 下 再 新 建 一 个 Shared 目录 。 

步骤 4: 在 Shared 目录 下 添加 布局 视图 文件 ,命名 为 _Layout. cshtml。 


<! DOCTYPE html > 
<html> 
<head> 
< meta name = "viewport" content = "width = device — width" /> 
<title>@ViewBag. Title </title> 
</head> 
<body> 
<div style= "height:100px; background - color:slateblue; position:relative"> 
<p style= "color:white;font - size:40px; position:absolute;margin ~ left:15px"> 
清新 小 站 
</p> 
</div> 
<div style= "margin - top:35px;margin ~ bottom:45px"> 
@RenderBody( ) 
</div> 
<div> 
<hr/> 
@ 2018 - 2018 版 权 所 有 
</div> 
</body> 
</html > 
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步骤 5: 在 Views 目录 下 新 建 Test 目录 (控制 器 名 为 Test) 。 
步骤 6: 在 Test 目录 下 添加 Default. cshtml 视图 。 


@{ 
Layout = "_ Layout"; 
} 
<div> 
网 站 主页 
</div> 
只 有 明确 设置 Layout 属性 后 ,视图 才能 使 用 布 “| 日 cames x 转 -9 x 
局 页 € 0O | kmheW A| 二 


步骤 7: 定义 Test 控制 器 。 


public class TestController : Controller 上 < 夫 立 | 
{ 月 TJ\Y 
public ActionResult Default() 
{ 网 站 主页 


return View(); 
} 
} | 虽 2018 - 2018 版 权 所 有 
步骤 8: 运行 应 用 程序 ,布局 页 与 内 容 页 合并 后 
的 效果 如 图 16-10 所 示 。 


实例 360”_ViewStart 视图 与 _ViewImports 视图 


【导语 】 

这 两 个 视图 文件 的 名 称 都 以 下 面 线 开头 ,表示 它们 有 特殊 用 途 , 一 般 不 向 客户 端 公开 。 
这 两 个 视图 不 用 于 定义 可 视 化 内 容 , 而 是 用 于 声明 一 些 在 视图 中 重复 使 用 的 指令 。 

_ViewImports 视图 专门 用 于 导入 命名 空间 , System、System. Threading. Tasks、 
Microsoft, AspNetCore. Mvc 等 命名 空间 中 的 类 型 在 视图 中 比较 常用 ,统一 在 
_ViewImports 视图 中 导入 ,不 需要 每 个 视图 文件 都 写 一 遍 using 指令 。 

_ViewStart 视图 用 来 放置 在 各 个 视图 中 都 可 能 重复 使 用 的 指令 (@page 指令 除外 ,这 
个 指令 必须 写 在 每 个 Razor Page 文件 的 第 一 行 ), 例 如 引用 布局 页 (一 般 命 名 为 _Layout)， 
可 能 在 每 个 视图 文件 中 都 要 写 这 些 指令 ,将 它们 一 次 性 写 到 _ViewStart 视图 中 ,后 面 就 不 
用 重复 去 写 了 。 在 执行 每 个 视图 文件 时 都 会 先 执行 _ViewStart 视图 中 的 代码 。 

_ViewStart 和 _ViewImports 并 不 要 求 放置 到 /View/Shared 目录 下 ,实际 上 ,它们 可 以 
放 在 任何 存 有 视图 文件 的 目录 下 ,只 对 当前 目录 及 子 目 录 下 的 视图 起 作用 。 举 个 例子 ,假设 
有 Data 控制 器 , 它 包 含 Delete 和 Update 两 个 视图 。 


图 16-10 应 用 了 布局 页 的 视图 


/Views 
/Data 
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/_ViewStart. cshtml 

/_ViewImports. cshtml 

/Delete. cshtml 

/Update. cshtml 
/Shared 

/OpenList. cshtml 


_ViewStart 和 _ViewImports 视图 位 于 Data 目录 下 ,它们 只 对 Delete 和 Update 两 个 
视图 起 作用 ,对 OpenList 视图 不 起 作用 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 Demo 控制 器 ,其 中 包含 五 个 操作 方法 ,默认 对 应 五 个 视图 。 


public class DemoController : Controller 

{ 
public ActionResult Index() => View(); 
public ActionResult Desc() => View(); 
public ActionResult News() => View(); 
public ActionResult Products() => View(); 
public ActionResult ContactUs() => View(); 

L 


步骤 3: 在 项 目 中 新 建 Views 目录 。 
步骤 4: 在 Views 目录 下 新 建 Shared 子 目录 ,并 在 其 中 存放 布局 视图 _Layout。 


@addTagHelper * ,Microsoft.AspNetCore.Mvc.TagHelpers 
<!DOCTYPE html > 


<html> 
<head> 
<meta name = "viewport" content = "width = device — width" /> 
<title>@ViewBag. Title </title> 
</head> 
<body> 
<nav> 
<aasp— controller = "Demo" asp — action = "Index"> 主 页 </a> 
<aasp— controller = "Demo" asp - action = "Desc"> 公 司 简 介 </a> 
<aasp— controller = "Demo" asp — action = "News"> 新 闻 </a> 
<aasp— controller = "Demo" asp - action = "Products"> 产 品 信息 </a> 
<aasp— controller = "Demo" asp - action = "ContactUs"> 联 系 我 们 </a> 
</nav> 
< div> 
@RenderBody( ) 
</div> 
</body> 
</html > 


480 | .NET Core 实战 一 手把手 教 你 学 握 380 个 精彩 案例 


<nayv > 标签 所 定义 的 导航 栏 中 包含 指向 五 个 视图 的 链接 .此 处 可 以 使 用 asp-controller 
和 asp-action 两 个 标签 帮助 器 使 框架 自动 生成 导航 的 URL。 

步骤 $: 在 Views 目录 下 新 建 Demo 目录 ,对 应 控制 器 Demo。 

步骤 6: 在 Demo 目录 下 添加 五 个 视图 文件 ,对 应 Demo 控制 器 中 的 五 个 Action , 详 见 
代码 清单 16-1 。 


代码 清单 16-1 五 个 视图 的 HTML 文档 


// Index. cshtml 
<h3 > 主页 </h3 > 


// Desc. cshtml 
<h3 > 公司 简介 </h3 > 


// News. cshtml 
<h3 > 公司 新 闻 </h3 > 


// Products. cshtml 
< h3 > 产品 概览 </h3 > 


// ContactUs. cshtml 
< h3 > 联系 我 们 </h3 > 


步骤 7: 在 Demo 目录 下 添加 _ViewImports 视图 文件 ,导入 可 能 会 被 用 到 的 命名 空间 。 


@using System 
@using Microsoft. AspNetCore. Mvc 
@using Microsoft. AspNetCore. Mvc. TagHelpers 


步骤 8: 在 Demo 目录 下 添加 _ViewStart 视图 文件 ,并 写 入 会 在 视图 中 被 重复 使 用 的 代码 。 


@!{ 
Layout = "_Layout"; 
} 
@addTagHelper * ,Microsoft.AspNetCore.Mvc.TagHelpers 


步骤 9: 运行 应 用 程序 ,结果 如 图 16-11 和 图 16-12 所 示 。 


localhost 日 eaanos x[+ mx 
© ©O | o eeay 方 国王 0 km om 六 | 二 
主页 公司 简介 新 闻 产品 信息 联系 我 们 主页 公司 简介 新 闻 产品 信息 联系 我 们 
主页 产品 概览 


图 16-11 示例 应 用 的 主页 图 16-12 示例 应 用 的 产品 视图 
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实例 361 ”向 视图 传递 模型 对 象 


【导语 】 

在 实际 应 用 中 ,经 常 需要 在 控制 器 中 向 视图 传递 数据 ,这 些 数据 可 以 称 为 “模型 ” 
(Model) ,MVC 框架 中 的 “M” 指 的 就 是 Model。 

模型 可 以 是 任意 类 型 ,一 般 是 自 定义 的 类 ,这 些 类 可 以 被 映射 到 数据 库 的 某 个 数据 表 
中 ,使 用 时 从 数据 库 中 加 载 ,修改 后 用 于 更 新 数据 库 ; 也 可 以 在 代码 中 直接 使 用 这 些 类 , 直 
接 将 其 实例 传递 到 视图 中 。 

在 Razor 视图 文件 中 ,需要 先 用 @model 指定 声明 模型 对 象 的 数据 类 型 ,然后 在 视图 的 
任何 地 方 通过 Model 属性 来 引用 模型 实例 。 在 控制 器 类 中 ,有 两 种 方法 传递 模型 对 象 ; 
中 通过 ViewData. Model 属性 来 传递 ; 回调 用 View 方法 时 将 模型 实例 赋值 给 方法 参数 。 
其 实 , 两 种 传递 模型 方法 的 本 质 是 相同 的 ,都 使 用 了 ViewData. Model 属性 。View 方法 的 
内 部 实现 是 先 将 模型 实例 赋值 给 ViewData. Model 属性 ,然后 在 创建 ViewResult 实例 时 ， 
将 Controller 类 ViewData 属性 的 引用 赋值 给 ViewResult 对 象 的 ViewData 属性 。 

本 实例 的 数据 模型 是 Student 类 , 先 在 控制 器 中 创建 一 个 用 于 测试 的 Student 对 象 列表 ， 
然后 把 这 个 列表 传递 给 视图 ,在 视图 中 可 以 使 用 HTML 元 素来 呈现 列表 中 的 数据 信息 。 

【操作 流程 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 一 个 Student 类 ,作为 示例 的 数据 模型 。 


public class Student 

{ 
public Guid ID { get; set; } 
public string Name { get; set; } 
public int Age { get; set; } 
public string Course { get; set; } 

} 


步骤 3: 定义 控制 器 。 


public class StudentController : Controller 


{ 
public ActionResult AllStudents() 
{ 


IList< Student > stus = new List< Student >(); 
stus. Rdd(new Student 
{ 
ID = Guid. NewGuid(), 
Name = "小 获 "， 
Rhge = 21, 
Course = "C++" 
D); 
stus. Add( new Student 
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ID = Guid. NewGuid(), 
Name = "小 王 "， 
AMge = 20, 
Course = "C" 
DD); 
stus. Add( new Student 
‘ 
ID = Guid. NewGuid(), 
Name = "小 刘 "， 
Rge = 23, 
Course = "HTML + CSS" 
])， 


ViewData. Model = stus; 
return View(); 


} 
在 返回 ViewResult 时 ,还 可 以 直接 通过 以 下 的 View 方法 来 传递 数据 模型 。 


public ActionResult AllStudents() 
€ 


return View(stus); 


: 


步骤 4: 在 项 目 中 新 建 Views 目录 ,然后 在 Views 目录 下 新 建 Student 子 目录 。 

步骤 5: 在 Student 目录 下 添加 视图 文件 AllStudents. cshtml。 

步骤 6: 需要 在 视图 文件 的 顶部 使 用 @model 指令 声明 模型 的 数据 类 型 ,本 实例 中 数据 
模型 的 类 型 为 IList < Student >。 


@using Demo 
@model IList< Student > 


步骤 7: 设计 HTML 文档 内 容 , 使 用 < table > 标签 来 显示 列表 中 Student 对 象 的 属性 值 。 


< htm]l > 
<body> 
< style type = "text/css"> 
table { 
border — style: solid; 
border - color: blue; 
border — spacing:20px 5px 
} 
</style> 
@{ 
if (Model != null && Model.Count > 0) 
<table> 
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< caption > 学员 列表 </caption> 


<thead> 
<tr> 
<th> 编 号 
<th> 姓 名 
<th> 年 龄 
<th> 学 习 课 程 
<tbody> 
@{ 
foreach (Student s in Model) 
a 
<td>@s.ID 
<td>@s. Nane 
<td>@s. Age 
<td>@s. Course 
</tr> 


} 
} 
</tbody> 
</table> 
| 
else 
{ 
<div> 无 学 员 信 息 </div> 
} 
} 
</body> 
</html > 


注意 ; 由 于 Razor 语法 可 以 与 HTML 元 素 混 编 ,比较 容易 出 错 ,因此 在 编写 视图 文档 时 要 
格外 小 心 ,尤其 是 开始 标签 与 结束 标签 之 间 的 匹配 。 


步骤 8: 运行 应 用 程序 。 
步骤 9: 在 浏览 器 地 址 栏 中 输入 http: //localhost: 11025/student/allstudents, 按 
Enter 键 确认 后 可 以 看 到 如 图 16-13 所 示 的 效果 。 


BB localhost 


3 ©O MO 0O locahostii02 


姓名 


49a6alfa-8e04-46d9-9209-5c6a7c88401d 
2c84324c-cd6b-46a5-a35b-716488138abb ”小 王 
33dc8a2d-6eb5-4893-908f-cc5d566d54fD 。 小 刘 


图 16-13 在 视图 中 呈现 数据 模型 
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实例 362 在 控制 器 中 接收 服务 列表 的 注入 


【导语 】 

为 了 便于 扩展 和 维护 ,服务 类 型 有 时 使 用 “接口 -实现 类 ”的 方式 来 开发 ,因此 一 个 服务 
接口 可 能 会 按照 不 同 的 功能 有 多 个 实现 类 。 在 注册 服务 时 ,一 种 方案 是 以 接口 的 实现 类 作 
为 服务 类 型 ,分 别 添加 到 服务 容器 中 ,在 依赖 注入 时 ,分 别 接受 各 个 实现 类 型 ; 另 一 种 方案 
是 以 共同 的 接口 作为 服务 类 型 ,把 多 个 实现 类 型 添加 到 服务 容器 中 ,在 依赖 注入 时 ,可 以 使 
用 IEnumerable< T > 来 单独 接收 服务 列表 。 

本 实例 将 演示 在 控制 器 的 构造 函数 中 接收 服务 类 型 列表 ,此 方案 适用 于 所 有 支持 依赖 
注入 的 方法 ,例如 Startup 类 的 Configure 方法 .中 间 件 类 的 Invoke 方法 等 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 声明 一 个 接口 ,作为 各 个 服务 实现 类 的 共同 规范 。 


public interface ITestService 
{ 

string HashName { get; } 

string GetResult( string input); 
} 


步骤 3: 定义 两 个 类 ,都 实现 上 述 接口 ,一 个 使 用 MD5 哈 希 算法 进行 计算 , 另 一 个 使 用 
SHA256 哈 希 算法 进行 计算 , 详 见 代码 清单 16-2。 


代码 清单 16-2 ”两 个 服务 实现 类 


public class MD5CrtTest : ITestService 


{ 
public string HashName => "MD5"; 


public string GetResult(string input) 
if (string. IsNullOrEmpty( input)) 
. 
return null; 
} 
byte[ ] data = Encoding. UTF8.GetBytes( input); 
string result = null; 
using(MD5 md5 = MD5.Create()) 
人 
byte[ ] output = md5. ComputeHash(data) 
result = Convert.ToBase64String(output); 
} 


return result; 
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} 


public class SHA256Test : ITestService 


{ 
public string HashName => "SHA256"; 


public string GetResult(string input) 


{ 
if (string. IsNullOrEmpty( input)) 


{ 


return null; 


} 

byte[ ] contentbytes = Encoding.UTF8.GetBytes(input); 
byte[ ] computedbytes = null; 

using(SHA256 sha256 = SHA256.Create()) 


{ 
computedbytes = sha256.ComputeHash(contentbytes); 


} 
return Convert. ToBase64String(computedbytes); 


l: 


步骤 4: 在 初始 化 应 用 程序 时 ,通过 WebHostBuilder 类 的 ConfigureServices 方法 注册 
服务 (也 可 以 在 Startup. ConfigureServices 方法 中 注册 )。 


new WebHostBuilder() 


.ConfigureServices(services => 


{ 


services. AddMvc( ); 
services. AddScoped < ITestService, MD5CrtTest >(); 
services. AddScoped < ITestService, SHA256Test >(); 


}) 
.Build() 
.Run(); 
步骤 5: 定义 Demo 控制 器 ,其 中 公开 Encode 方法 , 先 从 HTTP 请 求 的 查询 参数 中 读 
取 名 为 text 的 参数 值 ,再 用 注入 的 服务 类 实例 进行 喻 希 计算 ,最 后 以 JSON 格式 将 结果 返 
给 客户 端 。 


加 


public class DemoController : Controller 
{ 


IEnumerable < ITestService> _encoders; 
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public DemoController( IEnumerable < ITestService> svs) 
1 
_encoders = svs; 


} 


[HttpGet] 
public JsonResult Encode( ) 
{ 
// 获取 文本 
string q = Request. Query[ "text"]; 
IDictionary < string, string> dic = new Dictionary< string, string>(); 
dic["text"] = q; 
// 分 别 用 注入 的 服务 进行 哈 希 计算 
foreach( ITestService sv in _encoders) 
t 
stringr = sv.GetResult(q); 
dic[sv.HashName] = r; 
} 


return Json(dic); 


} 


以 IEnumerable < ITestService > 类 型 作为 构造 函数 参数 的 类 型 可 以 接受 整个 类 型 列表 
的 依赖 注入 ,这 些 类 型 的 条 件 是 都 实现 了 ITestService 接口 。 

HttpGet 特性 描述 的 Encode 方法 接受 HTTP-GET 方式 的 请 求 ,并 且 返 回 JSON 格式 
的 数据 ,此 方法 不 返回 视图 , 即 作 为 Web API 公开 。 

步骤 6: 运行 应 用 程序 ,并 用 以 下 URL 进行 测试 。 


http://localhost:6974/demo/encode?text = 我 是 客户 端 
text 参数 可 以 提交 用 于 哈 希 计 算 的 文本 ,请求 后 Web 服务 将 回应 以 下 内 容 。 


{ 

"text": "我 是 客户 端 ", 

"MD5" : "BAX1qSj7J20ZbrsZGYdFxw ==", 

"SHA256": "B4x8EIu6E4T8Oh2kZ1k6 + NhL3ya6eg9J6my4unMmkp8 = " 
} 


实例 363 ”使 用 IFormCollection 组 件 来 提取 form 表单 数据 


【导语 】 

可 以 通过 < form > 元 素 收集 用 户 在 HTML 页 面 上 输入 的 内 容 , 提 交 到 服务 器 后 , 转 由 
指定 控制 器 中 的 某 个 操作 方法 进行 处 理 。 操 作 方 法 可 以 通过 参数 来 接收 所 提交 的 表单 
数据 。 

操作 方法 将 参数 声明 为 [FormCollection 类 型 ,HTML < form > 元 素 所 提交 的 内 容 会 存 
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放 在 IFormCollection 实例 中 ,然后 程序 代码 就 可 以 提取 实例 中 的 数据 ,其 结构 类 似 于 字典 
数据 类 型 ,通过 Key 可 以 检索 对 应 的 值 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 控制 器 Demo, 其 中 有 两 个 操作 方法 。 


public class DemoController : Controller 
{ 
public ActionResult Default() => View(); 


public ActionResult PostUp( IFormCollection form) 

{ 
IDictionary< string, string> dic = new Dictionary< string, string>(); 
foreach( string k in form. Keys) 
{ 

stringv = form[k]; 

dic[k] = 


} 


return View("Show", dic); 


} 


PostUp 方法 在 客户 端 进行 提交 后 执行 ,从 form 参数 中 提取 出 数据 ,并 转 存 到 一 个 字典 
实例 中 ,最 后 再 把 字典 实例 传递 给 Show 视图 。 


注意 ; IFormCollection 接口 的 默认 实现 类 是 FormCollection 类 ,但 是 在 声明 操作 方法 参数 
时 不 能 直接 使 用 FormCollection 作为 参数 类 型 ,而 要 使 用 IFormCollection 接口 。 


步骤 3: 以 下 是 Default 视图 的 代码 。 


<html> 
<body> 


<table> 
tr 
<td> 
< label for = "city"> 城 市 :</label > 
</td> 
<td> 
< input type = "text" name = "city" form= "form"/> 
</td> 
</tr> 
<tr> 
<td> 
<label for = "name"> 姓 名 :</label > 
</td> 
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<td> 
< input name = "name" type = "text" form= "form"/> 
</td> 
</tr> 
</table> 
< form id = "form" asp— controller = "Demo" asp— action = "PostUp"> 
< input type = "submit" value = "提交 "/> 
</form> 
</body> 
</html > 


asp-controller 和 asp-action 是 标记 帮助 器 ,用 于 指定 处 理 该 < form > 元 素 所 提交 内 容 的 
控制 器 和 操作 方法 。 在 服务 器 上 执行 帮助 器 代码 后 会 自动 生成 提交 的 URL。 
步骤 4: Show 视图 用 于 显示 在 前 一 个 视图 中 输入 的 内 容 。 


@model IDictionary< string, string> 


<html> 
<body> 
<h3 > 你 输入 的 内 容 </h3 > 
@!{ 


foreach(var i in Model) 
{ 
<p>@i.Key : @i.Value </p> 
} 
} 
</body > 
</html > 


@model 指令 用 于 声明 该 视图 接收 的 模型 对 象 为 字典 类 型 。 随 后 通过 Model 属性 即 可 
获取 字典 的 实例 引用 ,并 使 用 foreach 语句 枚 举 出 子 项 中 的 Key 与 Value 值 。 


步骤 $: 运行 应 用 程序 ,首先 进入 Default 视图 ,接收 用 户 的 输入 (如 图 16-14 所 示 )。 输 
入 完成 后 , 单 击 “ 提 交 ” 按 钮 , 转 到 Show 视图 ,显示 刚刚 输入 的 内 容 ( 如 图 16-15 所 示 )。 


localhost x 和 
包间 | @ locshostasr4Den [0 女 
你 输入 的 内 容 
city : 成 都 
name ; 小 张 
_ RequestVerificationToken : 
城市 : CfDJSOeZ5x9o2U5HrcwHCsEwJDGIwEzCS] 
MS I | < 
Es LB gdcu_3VIhX_kfBEcSg8805J02OmBqsYt9bVH 
[ea ,| 


图 16-14 输入 相关 内 容 图 16-15 显示 输入 的 内 容 
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实例 364 在 Web API 中 直接 提取 上 传 的 文件 


【导语 】 

Web API 通常 不 使 用 视图 ,如 果 调 用 客户 端 是 直接 向 服务 器 发 送 文件 内 容 , 而 不 是 通 
过 HTML < form > 方式 提交 ,那么 Action 方法 使 用 IFormFile 类 型 的 参数 是 无 法 接收 到 数 
据 的 。 一 个 非常 简单 的 解决 方法 就 是 直接 从 HttpContext 对 象 中 读 取 请 求 正 文 , 并 且 这 种 
方法 也 不 用 考虑 content-type,; 正 文 都 是 二 进 制 数据 ,以 流 的 形式 读 入 。 

本 实例 将 演示 一 个 允许 客户 端 直接 上 传 文件 的 Web API, 并 使 用 HTTP 头 来 提供 文 
件 名 。 

【操作 流程 】 

该 实例 包含 两 个 项 目 , 除 了 主要 的 ASP. NET Core 应 用 项 目 , 还 包括 一 个 控制 台 应 用 
项 目 ,用 于 测试 Web API 的 调用 。 

首先 是 ASP. NET Core 项 目的 实现 部 分 。 

步骤 1: 定义 Demo 控制 器 ,包含 UploadFile 方法 。 


public class DemoController : Controller 
{ 
[HttpPost] 
public ActionResult UploadFile() 
{ 
Var request = HttpContext. Request; 
Stream stream = request. Body; 
byte[ ] data = null; 
// 读 取 正 文 内 容 
using(MemoryStream ms = new MemoryStream()) 
{ 
stream. CopyTo(ms); 
data = ms.ToArray(); 
} 
// 提取 文件 名 
string fileName = request. Headers["file— name"]; 
// 返回 状态 码 200 
return Ok( $ "已 成 功 上 传 文件 {fileName??" 未 知 "}, 大 小 为 {data. Length} 字 节 "); 


于 此 处 仅 做 演示 ,并 没有 保存 接收 到 的 文件 内 容 , 所 以 只 向 调用 方 返回 一 条 上 传 成 功 
的 应 答 消息 。HttpRequest. Body 属性 就 是 HTTP 请 求 的 正文 内 容 ,以 流 的 形式 公开 ,并 且 是 
只 读 的 。 上 述 代 码 中 , 先 将 数据 复制 到 内 存 流 中 ,再 转换 为 字 节 数组 。 由 于 HttpRequest Body 
属性 所 公开 的 流 对 象 并 没有 实现 Length 属性 ,如 果 直 接 获 取 , 其 长 度 会 发 生 异 常 ,所 以 要 先 
把 内 容 复制 到 内 存 流 中 ,以 方便 处 理 。 

步骤 2: 一 般 来 说 ,文件 的 内 容 是 比较 大 的 ,有 可 能 超出 Kestrel 服务 器 的 默认 大 小 限 
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制 。 为 了 避免 文件 上 传 失败 ,需要 修改 对 正文 大 小 的 限制 。 在 应 用 程序 的 Program 类 中 找 
到 项 目 模 板 默认 生成 的 CreateWebHostBuilder 方法 ,对 它 做 如 下 修改 。 


public static IWebHostBuilder CreateWebHostBuilder(string[ ] args) => 
WebHost. CreateDefaultBuilder(args) 
.UseStartup < Startup>() 
.UseKestrel(o=> 


{ 
0.Limits. MaxRequestBodySize = 5000000000; 


D); 
MaxRequestBodySize 属性 限制 的 是 请 求 正文 的 最 大 长 度 , 一 般 只 需要 修改 这 一 选项 。 
接 下 来 实现 一 个 测试 的 客户 端 项 目 。 
步骤 3: 声明 一 些 稍 后 要 使 用 到 的 变量 。 


// 请 求 URL 

string url = "http://localhost:5000/demo/uploadfile"; 
// 测试 文件 名 

string FileName = "sample. dat"; 

// 产生 字 节 数 


int byteCount = 8000; 

以 变量 形式 存储 这 些 值 ,在 测试 代码 时 便于 修改 ,例如 文件 名 和 文件 大 小 。 本 实例 中 没 
有 使 用 真实 的 文件 ,而 是 生成 随机 字 节 来 模拟 文件 内 容 。 

步骤 4: 生成 随机 字 节 , 稍 后 用 于 提交 到 Web 服务 器 。 

byte[ ] bytes = new byte[byteCount]; 


Random rand = new Random(); 
rand. NextBytes(bytes); 


步骤 5: 向 服务 器 发 起 请 求 ,并 接收 响应 消息 。 


using(HttpClient client = new HttpClient()) 
{ 


// 设置 HTTP 头 

client. DefaultRequestHeaders. Add( "file— name", FileName); 
// 创建 正文 内 容 

ByteArrayContent content = new ByteArrayContent(bytes); 
// 发 起 请 求 


Console. WriteLine(" 正 在 发 送 数 据 , 请 稍 候 …… -fs 

HttpResponseMessage response = await client.PostAsync(url, content); 
string respmsg = await response.Content.ReadAsStringAsync(); 
Console. WriteLine( $ "服务 器 返回 消息 :\n{respmsg}"); 
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步骤 6: 运行 应 用 程序 ,结果 如 图 16-16 所 示 。 


图 16-16 直接 发 送 文 件 内 容 


实例 365 ”用 部 分 视图 来 显示 当前 日 期 


【导语 】 

本 实例 旨 在 演示 部 分 视图 的 用 法 , 仅 使 用 部 分 视图 来 显示 日 期 。 

部 分 视图 与 普通 视图 没有 太 大 区 别 , 它 可 以 将 一 些 重 复 使 用 的 HTML 内 容 组 合 起 来 ， 
可 以 单独 使 用 。 假 如 一 个 站 点 中 ,每 个 页 面 都 要 显示 登录 信息 ,如 果 用 户 已 登录 就 显示 登录 
的 用 户 信息 ; 如 果 没 有 登录 ,就 显示 用 户 名 和 密码 输入 框 以 便 用 户 进行 登录 操作 。 这 个 显 
示 登 录 信息 的 内 容 就 可 以 做 成 部 分 视图 ,并 在 多 个 视图 中 引用 。 

部 分 视图 不 应 该 公开 被 客户 端 访问 ,所 以 一 般 命名 的 时 候 会 在 视图 名 称 前 加 下 面 线 , 例 
如 _Login. cshtml、RegCounter. cshtml 等 。 部 分 视图 可 以 放 在 /Views/Shared 目录 下 或 者 
与 当前 控制 器 同名 的 目录 下 。 

【操作 流程 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 创建 Test 控制 器 ,公开 Default 操作 方法 。 


[Route("[controller]/[action]")] 
public class TestController : Controller 


\ 
public IActionResult Default() 
{ 
return View(); 
} 
: 


步骤 3: 在 项 目下 新 建 Views 目录 ,并 在 Views 目录 下 新 建 Shared 目录 。 
步骤 4: 在 Shared 目录 下 添加 一 个 部 分 视图 ,命名 为 _showDate. cshtml。 


< div style = "padding:25px 20px; border:2px solid yellow; background ~ color:1ightgoldenrodyellow"> 
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@DateTime. Today. Tostring("yyyy' 年 'M' 月 'd' 日 ', dddd") 


</div> 


步骤 5: 在 Views 目录 下 新 建 与 Test 控制 器 同名 的 目录 。 


步骤 6: 在 Test 目录 下 添加 Default. cshtml 视图 。 


< html > 
<body> 
< div> 
<h4 > 示例 程序 </h4 > 
</div> 
<div> 
@await Html. PartialAsync("_showDate") 
</div> 
</body> 
</html > 


如 果 要 引用 部 分 视图 ,可 以 调用 PartialAsync 方法 并 指定 要 引用 的 视图 的 名 称 。 与 普 
通 视图 一 样 ,对 于 可 以 被 查找 到 的 部 分 视图 ,不 需要 指定 路 径 和 扩展 名 。 
不 仅 可 以 调用 PartialAsync 方法 ,还 可 以 使 用 标记 帮助 器 来 引用 部 分 视图 。 首 先 使 用 


@addTagHelper 指令 导入 标记 帮助 器 的 类 型 。 
@addTagHelper * ,Microsoft.AspNetCore.Mvc.TagHelpers 
然后 使 用 < partial > 元 素来 指定 所 引用 的 部 分 视图 。 


<div> 
<partial name = "_showDate"/> 
</div> 
两 种 引用 部 分 视图 的 方法 , 任 选 其 一 即 可 。 
步骤 7: 运行 应 用 程序 ,访问 地 址 http: //< 测 试 域 
名 >/test/default, 就 可 以 看 到 如 图 16-17 所 示 的 效果 。 


实例 366 ”使 用 视图 组 件 
【导语 】 


localhost x 


€ 日。 @ localhost6m00nr 四 女 


示例 程序 


2018 年 10 月 11 日 ， 星 期 四 


图 16-17 显示 日 期 的 部 分 视图 


视图 组 件 (View Component) 与 部 分 视图 在 功能 上 比较 相似 ,但 视图 组 件 比 部 分 视图 更 
灵活 。 与 控制 器 相似 ,视图 组 件 可 以 实现 视图 与 代码 分 离 , 并 且 一 个 视图 组 件 可 以 返回 多 个 


视图 组 件 有 两 种 实现 方法 : 


(1) 直接 从 ViewComponent 类 派生 .并 包括 Invoke 或 InvokeAsync 方法 。 
(2) 自 定义 类 ,需要 在 类 上 应 用 ViewComponent 特性 (ViewComponentAttribute 类 )， 


并 包含 Invoke 或 InvokeAsync 方法 。 
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Invoke 或 InvokeAsync 方 法 是 约定 方法 ,允许 定义 方法 参数 ,返回 值 类 型 需要 实现 
IViewComponentResult 接口 。 框 架 默 认 实 现 了 两 个 类 型 一 一 ViewViewComponentResult 
与 ContentViewComponentResult。 对 于 Razor 文档 ,在 需要 呈现 视图 组 件 的 地 方 调用 
Component. InvokeAsync 方法 。 

视图 组 件 会 在 以 下 路 径 中 查找 视图 : 

(1) 共享 组 件 : 默认 位 于 /Views/Shared/Components/< 视 图 组 件 名称 >/< 视 图 > 
. cshtml。 共 享 的 视图 组 件 可 以 在 应 用 项 目 范 围 内 访问 。 

(2) 非 共享 组 件 : 默认 位 于 /Views/< 控 制 器 名 称 >/Components/< 视 图 组 件 名 称 >/< 视 图 > 
.cshtml。 非 共享 组 件 只 可 以 在 当前 控制 器 中 访问 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 视图 组 件 类 ,命名 为 Test。 


public class TestViewComponent : ViewComponent 
{ 
IHostingEnvironment m env = null; 
public TestViewComponent (IHostingEnvironment env) 
1 
m env = env; 
} 
public IViewComponentResult Invoke() 
1 
return View("_showInfo", m_env); 
} 
$ 


视图 组 件 的 名 称 可 以 带 “ViewComponent” 后 缀 ,这 是 可 选 的 。 视 图 组 件 必须 包含 
Invoke 或 者 InvokeAsync 方法 。 在 以 上 代码 中 ,方法 返回 _showInfo 视图 ,并 且 将 通过 依赖 
注入 获取 到 的 IHostingEnvironment 实例 作为 Model 传递 给 视图 。 

步骤 3: 定义 Demo 控制 器 ,并 返回 Start 视图 。 


public class DemoController : Controller 
{ 
public ActionResult Start() 
{ 
return View(); 
} 
} 


步骤 4: 在 项 目 中 新 建 Views 目录 。 
步 又 5: 在 Views 目录 下 新 建 Shared 目录 ,再 在 Shared 目录 下 新 建 Components 目 
录 , 用 于 放置 视图 组 件 相 关 的 视图 。 
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步骤 6: 在 Components 目录 下 新 建 一 个 与 Test 视图 组 件 同名 的 目录 。 
步骤 7: 在 Test 目录 下 添加 视图 文件 _showInfo. cshtml。 


@model Microsoft. AspNetCore. Hosting. IHostingEnvironment 


< div style = "color:redifont — size:18px"> 
<p> 
应 用 程序 名 称 :@Model. ApplicationName 
</p> 
<p> 
当前 运行 环境 :@Model. EnvironmentName 
</p> 
</div> 


@model 指令 用 于 声明 Model 属性 返回 的 类 型 (从 视图 组 件 代码 传递 进来 的 模型 对 象 ) 。 
步骤 8: 在 Views 目录 下 新 建 一 个 与 Demo 控制 器 同名 的 目录 。 
步骤 9: 在 Demo 目录 下 添加 Start. cshtml 视图 文件 。 


< html > 
<body> 
<div> 
<hl > 应 用 主页 </hl > 
</div> 
<hr/> 
<div> 
<h3> 以 下 为 视图 组 件 :</h3> 
@await Component. InvokeAsync( "Test") 
</div> 
</body> 
</html > 


Component. InvokeAsync 方法 有 两 种 方式 指定 要 使 用 的 视图 组 件 : 四 直接 以 字符 串 形 
式 给 出 视图 组 件 的 名 称 ; @ 直 接 引 用 视图 组 件 类 的 Type 对 象 , 可 以 用 typeof 运算 符 来 获 
取 , 格 式 如 下 。 


@await Component. InvokeAsync(typeof(TestViewComponent)) 


调用 Component. InvokeAsync 方法 的 代码 需要 以 单行 代码 的 方式 混 写 在 HTML 代码 
中 ,因为 访问 视图 组 件 后 会 返回 一 段 HTML 内 容 并 呈现 到 主 视图 上 , 即 不 能 在 代码 块 中 调 
用 方法 ,那样 会 导致 返回 的 HTML 内 容 无 法 呈现 。 

以 下 代码 不 可 取 


@{ 
await Component. InvokeAsync("Test"); 


} 
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步骤 10: 运行 应 用 程序 ,在 浏览 器 地 址 栏 中 输入 http: //< 测 试 域名 >/demo/start, 就 
能 看 到 如 图 16-18 所 示 的 效果 。 


Er 


< 器 |o@ mossz 加 文 | 时 |… 


应 用 主页 


以 下 为 视图 组 件 : 
应 用 程序 名 称 : Demo 
当前 运行 环境 : Development 


图 16-18 使 用 视图 组 件 显示 应 用 程序 的 环境 信息 


实例 367 ”在 视图 中 接收 依赖 注入 


【导语 】 
在 视图 文件 中 ,使 用 @inject 指令 可 以 接收 来 自 依赖 注入 的 对 象 实例 ,格式 如 下 。 


@inject < 类 型 > < 变量 名 > 
为 了 让 代码 能 够 访问 注入 的 对 象 ,应 当 为 其 分 配 一 个 局 部 变量 名 ,分 配 格式 如 下 。 
@ inject ILooger logger 


本 实例 将 演示 从 视图 中 接收 IHostingEnvironment 对 象 的 注入 ,然后 在 页 面 上 显示 应 
用 程序 的 名 称 ,运行 环境 和 程序 内 容 的 根 目录 。 

【操作 流程 

步骤 1: 新 建 空白 的 ASP. NET Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 类 中 配置 与 MVC 框架 相关 的 服务 与 中 间 件 。 

public void ConfigureServices( IServiceCollection services) 


{ 


services. AddMvc( ); 


¥ 


public void Configurel( IApplicationBuilder app) 
{ 

app. UseMvc( ); 
} 


步骤 3: 在 项 目 目录 下 新 建 Pages 目录 。 
步骤 4: 在 Pages 目录 下 添加 Razor 页 面 ,命名 为 Default. cshtml。 
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步骤 $: 在 页 面 文档 的 首 行 添 加 相关 指令 ,用 @inject 指令 接收 IHostingEnvironment 
类 型 的 注入 。 


@page "/" 
@inject Microsoft.AspNetCore.Hosting. IHostingEnvironment envhost 


步骤 6: 页 面 的 HTML 代码 如 下 。 


<div> 

当前 应 用 程序 :@envhost. ApplicationName 
</div> 
<div> 

运行 环境 :@envhost. EnvironmentName 
</div> 
<div> 

应 用 根 目录 :@envhost. ContentRootPath 
</div> 


步骤 7: 运行 应 用 程序 ,结果 如 图 16-19 所 示 。 
EE 国 
€ FO MO © peahos6ez7 | Es 
当前 应 用 程序 : Demo 


运行 环境 : Development 
应 用 根 目录 : C:\Users\limnii\sourcewepos\Demo\Demo 


图 16-19 显示 当前 运行 环境 的 信息 


16.3 静态 文件 与 目录 浏览 


实例 368 访问 静态 文件 


【导语 】 

静态 文件 是 相对 于 可 在 服务 器 上 执行 的 文件 (例如 Razor 视图 ) 而 言 的 ,常见 的 静态 文 
件 有 CSS 样式 表 、JavaScript 脚本 、 多 媒体 文件 .HTML 静态 页 面 等 。 

ASP. NET Core 应 用 程序 默认 是 不 启用 对 静态 文件 访问 的 ,如 果 启 用 对 静态 文件 的 访 
问 , 需 要 在 Startup. Configure 方法 中 调用 UseStaticFiles 方法 。 

静态 文件 在 默认 情况 下 位 于 项 目的 /wwwroot 目录 下 , 若 要 更 改 静 态 文件 位 置 ,可 以 使 
用 StaticFileOptions 类 来 进行 配置 。 

本 实例 演示 了 如 何 设 置 静态 文件 选项 ,使 得 视图 页 面 能 够 访问 位 于 /wwwroot/ 
extLibs/js 目录 下 的 JQuery 脚本 。 由 于 相对 路 径 比 较 元 长 ,本 实例 将 设置 一 个 简短 的 请 求 
路 径 /js, 即 通过 http: //localhost/js/jquery. js 就 能 访问 脚本 文件 了 。 
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【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 在 Startup. ConfigureServices 方法 中 注册 MVC 功能 服务 。 


public void ConfigureServices(IServiceCollection services) 
{ 


services. AddMvc( ); 
} 
步骤 3: 对 于 Startup. Configure 方法 ,在 调用 UseMvc 方法 之 前 ,需要 先 调 用 
UseStaticFiles 方法 对 静态 文件 参数 进行 配置 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 


StaticFileOptions sfoption = new StaticFileOptions 


{ 
FileProvider = new PhysicalFileProvider (Path. Combine (env. WebRootPath, "extLibs/ 


js")), 
RequestPath = "/js" 
}; 
app. UseStaticFiles( sfoption); 
app. UseMvc( ); 
} 
允许 访问 的 静态 文件 所 在 的 目录 为 /wwwroot/extLibs/js, 映 射 后 的 相对 URL 为 /js。 
之 所 以 先 于 UseMvc 方法 调用 UseStaticFiles 方法 ,是 为 了 优先 处 理 对 静态 文件 的 请 求 , 如 
果 客 户 端 访问 的 不 是 静态 文件 ,再 转 到 MVC 框架 进行 处 理 。 
步骤 4: 在 项 目 所 在 的 目录 下 新 建 一 个 Pages 目录 ,并 在 Pages 目录 中 添加 一 个 Razor 
页 面 ,命名 为 Index. cshtml。 
@page "~/" 
<! DOCTYPE html > 
<html> 


</html > 
步骤 5: 在 header 元 素 中 引用 jquery.js 脚本 。 
< script type = "text/javascript" src = "/js/jquery. js"></script> 


注意 : 访问 脚本 所 使 用 的 路 径 , 应 该 是 /js 路 径 下 的 文件 ,因为 在 配置 静态 文件 时 已 进行 了 
映射 。 
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步骤 6: 在 body 元 素 中 编写 正式 内 容 , 让 div 元 素 产生 向 右 移 动 的 动画 。 


<div> 
<button id= "btnstart"> 向 右 移动 </button> 
<button id = "btnreset"> 重 置 </button > 
</div> 
<div> 
<div id= "rect"/> 
</div> 
< script type = "text/javascript"> 
$("#btnstart").click(() =>{ 


localhost 
$ ("#rect").animate({ es 
left: 150 
yO EE2Ed 
D); 
$ ("#btnreset").click(() =>1{ 
$("#rect"),css("left", 0); 
D); 
</script > 
步骤 7: 运行 应 用 程序 ,效果 如 图 16-20 所 示 。 图 1620 答 形 向 右 移 动 
实例 369 开局 目录 浏览 功能 
【导语 】 
目录 浏览 功能 允许 客户 端 查看 某 个 Web 目录 下 的 子 目 录 和 文件 列表 ,可 以 直接 查看 或 
者 下 载 文件 。 
【操作 流程 】 


步骤 1: 新 建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 wwwroot 目录 下 创建 一 个 子 目 录 ,命名 为 images。 

步骤 3: 在 images 目录 下 放置 五 个 . gif 文件 (任意 文件 都 可 以 , 仅 用 于 测试 ) 。 

步骤 4: 在 Startup. ConfigureServices 方法 中 调用 AddDirectoryBrowser 方法 注册 相 


关 服 务 ( 此 方法 内 部 实质 上 是 调用 了 AddWebEncoders 方法 ) 。 


public void ConfigureServices(IServiceCollection services) 
{ 
services. AddDirectoryBrowser( ); 


} 
步骤 5: 在 Startup. Configure 方法 中 ,依次 调用 UseDirectoryBrowser 方法 和 


UseStaticFiles 方法 ,两 个 方法 的 调用 顺序 可 以 互 换 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 
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if (env. IsDevelopment()) 
{ 


app. UseDeveloperExceptionPage( ); 
app. UseStaticFiles(new StaticFileOptions 


FileProvider = new PhysicalFileProvider(Path.Combine(env.WebRootPath, "images")), 
RequestPath = "/gifs" 


app. UseDirectoryBrowser( new DirectoryBrowserOptions 
FileProvider = new PhysicalFileProvider(Path. Combine(env. WebRootPath, "images")), 
RequestPath = "/gifs" 

app. Run(async (context) => 


await context. Response. WriteAsync("Hello World! "); 


注意 : UseStaticFiles 方法 和 UseDirectoryBrowser 方法 的 参数 设置 相同 ,但 是 
UseStaticFiles 方法 必须 调用 ,否则 客户 端 只 能 浏览 目录 而 不 能 下 载 文件 。 如 果 既 
需要 浏览 目录 又 要 访问 静态 文件 ,比较 好 的 替代 方案 是 调用 UseFileServer 方法 。 


步骤 6: 运行 应 用 程序 ,访问 http: //< 测 试 域名 >/gifs 可 以 看 到 images 目录 下 的 文件 
(本 实例 只 允许 查看 images 目录 下 的 内 容 ) ,如 图 16-21 所 示 。 
5 


《和 > 口 自 © localhost57792/gifs/ 妇 世 | 大 8 


Index of /gifs/ 


Name Size Last Modified 
anm-1.gif © 1,827,158 2018-10-16 2:18:35 +00:00 
anm-2.gif 672,123 2018-10-16 2:18:56 +00:00 
anm-3.gif 29,310 2018-10-16 2:19:45 +00:00 
anm-4.gif 10.923 2018-10-16 2:20:08 +00:00 
anm-5.gif 24.136 2018-10-16 2:20:35 +00:00 


图 16-21 列 出 images 目录 下 的 文件 
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实例 370 文件 服务 


【导语 】 
当 应 用 项 目 既 需要 浏览 目录 结构 ,又 需要 访问 静态 文件 时 ,可 以 考虑 使 用 文件 服务 
功能 。 


UseFileServer 方法 综合 了 UseStaticFiles 方法 和 UseDirectoryBrowser 方法 的 功能 ， 
参数 可 以 通过 FileServerOptions 类 来 设置 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 wwwroot 目录 下 新 建 六 个 文本 文件 ,并 向 每 个 文件 中 随意 
输入 一 些 内 容 ,这些 文 件 仅 用 于 稍 后 测试 。 

步骤 3: 在 Startup. ConfigureServices 方法 中 调用 AddDirectoryBrowser 方 法 。 


public void ConfigureServices(IServiceCollection services) 
{ 


services. AddDirectoryBrowser( ); 


} 
步骤 4: 在 Startup. Configure 方法 中 调用 UseFileServer 方法 ,并 配置 好 相关 选项 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 
if (env. IsDevelopment( )) 
\ 
app. UseDeveloperExceptionPage( ); 
} 


app. UseFileServer(new FileServerOptions 

" 
FileProvider = new PhysicalFileProvider(env. WebRootPath), 
RequestPath = "/files", 
EnableDirectoryBrowsing = true 

D); 


app. Run(async (context) => 
{ 


await context. Response. WriteAsync("Hello World! "); 


}) 7 


注意 : 将 EnableDirectoryBrowsing 属性 设置 为 true 才 会 提供 浏览 目录 的 服务 ,如 果 不 设 置 
该 属性 ,就 相当 于 提供 静态 文件 服务 ,不 能 浏览 目录 结构 。 
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步骤 5: 运行 应 用 程序 ,效果 如 图 16-22 所 示 。 


Indexof /files/ x 


和 > 0 人 © localhost51883/fies/ 广 | 写 | 冯 志 


Index of /files/ 


Name | Size Last Modified 
file 1txt 10 2018-10-16 3:49:03 +00:00 
file 2txt 10 2018-10-16 3:49:21 +00:00 
file 3txt 10 2018-10-16 3:49:37 +00:00 
fle 4txt 10 2018-10-16 3:49:59 +00:00 
file 5txt 10 2018-10-16 3:50:17 +00:00 
file 6txt 10 2018-10-16 3:50:34 +00:00 


图 16-22 列 出 六 个 文本 文件 


应 用 配置 与 数据 库 访 问 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 配置 应 用 程序 ; 

。 选项 类 ，; 

。 EF Core( 实 体 框架 ) 。 


17.1 配置 应 用 程序 


实例 371 自 定 义 环 境 变量 的 命名 前 绷 


【导语 】 

用 于 对 应 用 程序 进行 配置 的 环境 变量 的 默认 前 缀 为 “ASPNETCORE_”, 例 如 ,配置 应 
用 启动 URL 的 环境 变量 名 为 “ASPNETCORE_URLS”, 配 置 运行 环境 的 环境 变量 名 为 
“ASPNETCORE_ENVIRONMENT”。 

但 有 了 时 不 希望 使 用 默认 的 环境 变量 前 级 ,本 实例 将 演示 自 定义 环境 变量 命名 前 级 的 
方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 使 用 ConfigurationBuilder 类 添加 环境 变量 配置 源 。 

var configBuilder = new ConfigurationBuilder() 

. AddEnvironmentVariables("APP "); 

调用 带 prefix 参数 的 AddEnvironmentVariables 重 载 方法 ,prefix 参数 为 字符 串 类 型 ， 
用 来 指定 环境 变量 的 命名 前 级 。 本 实例 指定 的 前 缀 为 “APP_”, 即 所 有 有 效 的 环境 变量 名 都 
必须 以 此 前 缀 开头 ,例如 “APP_URLS”。 

步骤 3: 使 用 上 面 的 配置 数据 来 配置 WebHostBuilder。 


var hostBuilder = new WebHostBuilder() 
.UseKestrel() 
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.UseContentRoot (Directory. GetCurrentDirectory()) 
.UseConfiguration(configBuilder. Build()) 
.UseStartup< Startup>(); 
hostBuilder. Build().Run(); 
ConfigurationBuilder 实例 需要 调用 Build 方法 生成 配置 信息 ,再 通过 WebHostBuilder 
实例 的 UseConfiguration 扩展 方法 应 用 配置 。 
步骤 4: 在 “解决 方案 资源 管理 器 "窗口 中 右 击 项 目 名 称 ,从 快捷 菜单 中 选择 “属性 ” 命 
令 , 打 开 “ 项 目 属性 ”窗口 。 
步骤 5: 切换 到 “调试 "选项 卡 , 在 环境 变量 结 点 处 添加 两 个 环境 变量 ,如 图 17-1 所 示 。 


环境 变量 - 名 称 值 


MPP URLS http://localbost-12130 添加 


APP_ENVIRONMENT |Developeent 
加 


图 17-1 配置 环境 变量 


注意 : 此 处 环境 变量 的 前 级 已 变 为 “APP_”。APP_URLS 配置 应 用 程序 的 启动 URL， 
APP_ENVIRONMENT 配置 应 用 程序 的 运行 环境 。 


步骤 6: 保存 设置 并 关闭 “项 目 属性 ”窗口 。 
步骤 7: 创建 一 个 简单 的 Demo 控制 器 , 稍 后 用 来 测试 应 用 程序 。 


[Route("/demo/[action]")] 
public class DemoController : Controller 


{ 
public IActionResult Index() 


{ 
return View( ); 

} 
} 
步骤 8: 在 项 目 中 创建 Views 目录 ,在 Views 目录 下 创建 Demo 子 目录 。 
步骤 9: 添加 Index 视图 ,HTML 代码 如 下 。 
< hl > 测试 网 站 </hl > 
<h4 > 欢迎 来 到 主页 。</h4 > 
步骤 10: 运行 应 用 程序 ,在 浏览 器 地 址 栏 中 输入 http: //localhost: 12130/demo/ 

index, 如 果 视 图 正常 显示 ,表明 环境 变量 配置 无 误 。 
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实例 
【导语 】 


372 ”使 用 JSON 文件 进行 配置 


使 用 JSON 文件 配置 应 用 程序 ,修改 起 来 方便 ,不 用 重新 编译 应 用 程序 ,而 且 可 以 移植 


到 其 他 应 用 


程序 中 使 用 。 


ConfigurationBuilder 在 生成 配置 数据 之 前 ,可 以 添加 多 个 配置 来 源 , 如 命令 行 参数 、 环 
境 变量 JSON 文件 ,内 存 中 的 字典 数据 等 。 其 中 ,调用 AddJsonFile 扩展 方法 可 以 添加 来 自 
JSON 文件 中 的 配置 数据 ,AddJsonFile 方法 可 以 多 次 调用 ,以 便 添加 来 自 多 个 JSON 文件 


的 数据 。 一 


般 来 说 ,用 于 配置 的 JSON 文件 都 会 放 在 与 应 用 程序 相同 的 目录 下 ,此 时 可 以 调 


用 SetBasePath 扩展 方法 设 定 一 个 基础 路 径 , 以 后 调用 AddJsonFile 方法 时 只 需要 指定 文件 


的 相对 路 径 
如 果 同 
如 ,urls 用 了 


(相对 于 SetBasePath 方法 所 指定 的 路 径 ) 。 
一 个 配置 项 在 多 个 配置 源 中 重复 出 现 , 那 么 后 面 添加 的 值 会 覆盖 前 面 的 值 。 例 
FF 设置 Web 服务 器 运行 时 接收 请 求 的 地 址 ,假设 它 被 设置 了 两 次 ,第 一 次 设置 为 


http: //localhost: 900, 第 二 次 设置 为 http: //localhost: 1600, 那 么 应 用 程序 启动 时 会 选 


择 http: // 
如 果 应 


localhost: 1600 作为 监听 URL。 
用 程序 在 Main 入 口 点 处 调用 了 WebHost. CreateDefaultBuilder 方法 ,那么 默 


认 情 况 下 会 使 用 名 为 appsettings. json 的 JSON 文件 进行 配置 。 
【操作 流程 】 


步骤 1 
步骤 2 


: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
: 在 项 目 中 添加 一 个 控制 器 ,名 为 Demo。 


public class DemoController : Controller 


{ 


public IActionResult Index() 


{ 


} 
} 


步骤 3 
步骤 4 


return View(); 


: 在 项 目 目录 下 新 建 Views 目录 ,再 在 Views 目录 下 新 建 Demo 子 目录 。 
: 添加 Index 视图 。 


@inject Microsoft. AspNetCore. Hosting. IHostingEnvironment env 


<div> 


<h4> 


应 用 程序 名 称 :@env. ApplicationName 


</h4 > 
<h4> 


运行 环境 :@env.EnvironmentName 


</h4 > 


</div> 
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步骤 $: 在 项 目 中 添加 一 个 JSON 文件 ,命名 为 hosting. json。 
{ 


"applicationName" : "Demo", 
"urls" : "http://localhost:22800", 
"environment" : "Debugging" 


步骤 6: 在 Main 入 口 点 中 ,将 上 面 的 hosting. json 文件 添加 到 配置 源 中 


o 


IConfigurationBuilder cfgbd = new ConfigurationBuilder() 
. SetBasePath(Directory. GetCurrentDirectory()) 
. AddJsonFile( "hosting. json"); 


步骤 7: 创建 WebHost 实例 的 相关 设置 。 


var hostbd = new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot (Directory. GetCurrentDirectory( )) 
.ConfigureServices(svs => 
1 
svs. AddMvc( ); 
}) 
.Configure(app => 


{ 
app. UseMvc (route => 
{ 
route. MapRoute( "default", 
"{controller = Demo}/{action = Index}"); < i 六 
0 应 用 程序 名 称 : Demo 
}) 
.UseConfiguration(cfgbd. Build()); 运行 环境 : Debugging 
步骤 8: 启动 WebHost 实例 。 
hostbd. Build( ). Run( ); 图 17-2 显示 应 用 名 称 与 运行 环境 名 称 


步骤 9: 运行 应 用 程序 ,结果 如 图 17-2 所 示 。 


实例 373” 自 定义 命令 行 参数 映射 


【导语 】 
ASP. NET Core 应 用 程序 支持 通过 传递 命令 行 参数 来 配置 应 用 程序 ,这 些 命令 行 参数 
追加 到 dotnet run 或 dotnet < 应 用 程序 . dll > 之 后 。 例 如 ,编译 应 用 程序 后 生成 的 文件 为 
LeetAPI. dll, 下 面 三 种 方式 都 可 以 使 用 命令 行 参数 来 配置 应 用 程序 的 监听 URL。 
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dotnet LeetAPI. dll urls = http://localhost:6570 

dotnet LeetAPI.dll - urls http://localhost:6570 

dotnet LeetAPI. dll /urls http://localhost:6570 

默认 情况 下 ,命令 行 参数 的 名 称 与 配置 项 的 名 称 相同 ,但 是 也 可 以 在 命令 行 参数 和 配置 
项 之 间 创 建 一 个 映射 关系 ,使 命令 行 参数 的 名 称 与 配置 项 的 名 称 不 同 。 例 如 ,将 应 用 程序 运 
行 环境 的 配置 项 命名 为 environment, 这 个 名 字 太 长 ,可 以 使 用 命令 行 参 数 。 或 者 env 来 指 
向 environment 配置 项 。 命 令 行 参数 的 映射 列表 是 一 个 字典 对 象 , 其 中 ,Key 表示 命令 行 参 
数 的 名 称 ,Value 表示 配置 项 的 名 称 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Main 入 口 点 中 ,声明 一 个 字典 类 型 的 变量 ,对 命令 行 参数 进行 映射 。 

IDictionary < string, string> mapping = new Dictionary< string, string> 

, == “es 

["—-—- env"] = "environment" 

}; 

经 过 映射 后 ,设置 应 用 程序 监听 URL 的 命令 行 参数 为 -u, 设 置 运行 环境 的 命令 行 参数 
为 -env。 

步骤 3: 创建 ConfigurationBuilder 实例 ,并 添加 命令 行 参数 作为 配置 来 源 。 


IConfigurationBuilder configbd = new ConfigurationBuilder() 
.AddCommandLine(args, mapping); 


步骤 4: 将 配置 信息 应 用 到 Host 上 。 


var hostbd = new WebHostBuilder() 
.UseConfiguration(configbd. Build()) 
.UseKestrel() 
.UseContentRoot (Directory. GetCurrentDirectory()) 
.UseStartup < Startup>(); 
hostbd. Build( ). Run(); 
步骤 5: 打开 项 目 属性 窗口 ,切换 到 “调试 "选项 页 。 
步骤 6: 填写 “应 用 程序 参数 ”( 即 命令 行 参数 )。 


——u http://localhost:7000 —— env Test 
步骤 7: 运行 应 用 程序 ,从 控制 台 的 输出 信息 中 可 以 查看 以 上 命令 行 参数 是 否 已 成 功 应 用 。 
实例 374 ”使 用 内 存 中 的 配置 源 


【导语 】 
配置 数据 不 仅 可 以 来 源 于 命令 行 参数 JSON 文件 .环境 变量 等 渠道 ,还 可 以 来 自 内 存 
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中 的 对 象 ,其 实质 是 一 个 字典 实例 。 内 存 配置 比较 适用 于 在 应 用 程序 运行 过 程 中 使 用 的 并 
且 不 需要 经 常 修改 的 内 容 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 创建 一 个 字典 实例 ,并 填充 初始 化 数据 。 


var data = new Dictionary< string, string> 

{ 
["environment"] = "Debug", 
["urls"] = "http://localhost:990", 
["contentRoot"] = Directory.GetCurrentDirectory(), 


}; 


本 实例 共 进 行 了 三 项 配置 : 应 用 程序 的 运行 环境 、Web 服务 器 监听 请 求 的 URL 和 应 
用 程序 内 容 的 根 目 录 。 
步骤 3: 使 用 ConfigurationBuilder 类 添加 内 存 配 置 源 。 


var configbd = new ConfigurationBuilder() 
.AddInMemoryCollection(data); 


步骤 4: 使 用 内 存 配置 初始 化 WebHost 实例 。 


var webhostbd = new WebHostBuilder() 
.UseKestrel() 
.UseConfiguration(configbd. Build()) 
.UseStartup< Startup>(); 

webhostbd. Build( ). Run( ); 


步骤 5: 在 Startup 类 中 添加 并 开启 MVC 功能 。 


public void ConfigureServices(IServiceCollection services) 
{ 
services. AddMvc( ); 


public void Configure(IRpplicationBuilder app, IHostingEnvironment env) 
{ 
if (env. IsDevelopment()) 
{ 
app. UseDeveloperExceptionPage( ); 
} 


app. UseMvc( ); 
} 


步骤 6: 在 项 目 目 录 下 新 建 一 个 Pages 目录 ,并 在 Pages 目录 下 添加 一 个 Razor 文件 ， 
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命名 为 Index。 


@page "/" 
@using Microsoft. Extensions. Configuration 
@ inject IConfiguration config 
<!DOCTYPE html > 
<html> 
<head> 
<meta charset = "utf — 8" /> 
<title>@config["applicationName"]</title> 
</head> 
<body> 
<p> 应 用 程序 名 称 :@config["applicationName"]</p> 
<p> 运 行 环境 :@config[ "environment"]</p> 
<p> 监 听 URL:@config["urls"]</p> 
</body> 
</html > 
该 页 面 的 作用 是 输出 三 个 配置 项 。 在 页 面 顶部 ,通过 @inject 指令 可 以 接收 
IConfiguration 类 型 的 依赖 注入 (在 构建 WebHost 对 象 的 过 程 中 ,应 用 程序 会 将 
IConfiguration 注册 到 服务 容器 内 )。 在 配置 数据 中 ,urls 和 environment 是 在 内 存 配置 源 中 产 
生 的 ,而 applicationName 则 由 应 用 程序 自动 配置 的 ,一 般 是 当前 应 用 程序 的 程序 集 名 称 。 


步骤 7: 运行 应 用 程序 ,结果 如 图 17-3 所 示 。 


EE 


p © localhost990/ 疤 
应 用 程序 名 称 : Demo 
运行 环境 : Debug 


监听 URL: http://localhost:990 


图 17-3 在 页 面 上 显示 配置 信息 


17.2 选项 类 


实例 375 ”选项 类 的 使 用 方法 

【导语 】 

选项 类 本 质 上 就 是 常见 的 类 (class) ,通常 它 会 公开 一 些 属性 ,用 来 读 写 相关 的 选项 。 
框架 内 部 也 定义 了 许多 选项 类 (选项 类 的 命名 一 般 会 以 Options 结尾 ), 例如 
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RazorPagesOptions 类 可 用 于 设置 与 Razor 页 面相 关 的 参数 , 它 的 RootDirectory 属性 可 以 
设置 查找 页 面 的 根 目 录 , 默 认为 /Pages。 

定义 选项 类 之 后 ,需要 在 ConfigureServices 方法 中 将 其 注册 到 服务 容器 内 。 选 项 类 的 
作用 是 进行 配置 ,区 别 于 一 般 的 服务 类 型 ,因此 在 接收 依赖 注入 时 ,应 当先 选用 IOptions 
< TOptions > 类 型 来 接收 对 象 的 引用 ,再 从 实例 的 Value 属性 中 获得 选项 类 的 实例 。 

【操作 流程 】 

步骤 1: 创建 一 个 自 定义 的 选项 类 ,本 实例 中 将 其 命名 为 DemoOptions, 它 有 三 个 公共 属性 。 


public class DemoOptions 

{ 
public string OptionA { get; set; } 
public string OptionB { get; set; } 
public string OptionC { get; set; } 

: 


步骤 2: 在 Startup. ConfigureServices 方法 中 将 选项 类 注册 到 服务 容器 内 。 


public void ConfigureServices(IServiceCollection services) 
{ 

services. AddMvc( ); 

services. Configure < DemoOptions >(o => 


{ 
o. 0ptionR = "选项 1"; 
o.0ptionB = "选项 2"; 
o.0ptionC = "选项 3"; 


)) 
Configure< TOptions > 方法 可 以 通过 一 个 委托 对 象 来 初始 化 DemoOptions 选项 类 的 
属性 。 
步骤 3: 在 项 目 目录 下 创建 一 个 Pages 目录 ,然后 在 Pages 目录 下 添加 一 个 test 页 面 。 
步骤 4: 在 Razor 文件 中 ,使 用 @inject 指令 来 接收 选项 类 的 注入 。 


@inject IOptions < DemoOptions> opt 
步骤 $: 获取 DemoOptions 实例 的 引用 。 


@{ 
DemoOptions doption = opt?. Value; 
} 


步骤 6: 在 页 面 上 显示 DemoOptions 选项 类 的 各 个 属性 的 值 。 


@if(doption !{= null) 
{ 
<p>@string. Format("{0} : {1}", nameof(doption. OptionA), doption. OptionA)</p> 
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<p>@string. Format("{0} : {1}", nameof(doption. OptionB), doption. OptionB)</p> 
<p>@string. Format("{0} : {1}", nameof(doption. OptionC), doption. OptionC)</p> 
} 


else 


<p> 暂 无 选项 信息 </p> 
} 


步骤 7: 运行 应 用 程序 ,结果 如 图 17-4 所 示 。 


EE | 
€ OO | @ localhost7e26/ 加 女 
OptionA : 选项 1 

OptionB : 选项 2 

OptionC : 选项 3 


图 17-4 输出 选项 类 的 属性 值 


实例 376 ”使 用 JSON 文件 来 配置 选项 类 


【导语 】 

初始 化 选项 类 最 简单 的 方法 ,是 在 调用 Configure< TOptions > 方法 时 通过 传人 的 委托 
对 象 来 设置 各 个 属性 的 值 ,该 方法 的 缺点 是 如 果 需 要 经 常 修改 选项 类 的 数据 的 话 , 在 每 次 更 
新 属性 后 都 要 重新 编译 应 用 程序 。 而 使 用 JSON 文件 来 配置 选项 类 的 初始 数据 是 一 种 比较 
实用 的 方案 , 当 要 进行 更 新 时 ,只 需 修 改 JSON 文件 中 的 内 容 , 可 以 免 去 重新 编译 和 发 布 应 
用 程序 的 麻烦 。 

使 用 JSON 文件 配置 时 ,首先 使 用 ConfigurationBuilder 类 添加 JSON 文件 配置 源 。 然 
后 调用 Build 方法 生成 配置 信息 ,可 以 在 配置 WebHostBuilder 时 通过 UseConfiguration 方 
法 应 用 配置 信息 ,再 经 过 依赖 注入 提供 给 Startup 类 。 最 后 在 ConfigureServices 方法 中 调 
用 Configure< TOptions > 方法 ,并且 传递 配置 信息 来 初始 化 选项 类 。 

从 JSON 文件 中 提取 选项 类 的 属性 值 .实质 上 是 一 个 反 序列 化 的 过 程 ,这 就 要 求 JSON 
文件 中 的 字段 名 称 必须 与 选项 类 的 属性 名 称 匹 配 (字段 名 称 的 首 字母 允许 使 用 小 写 ) 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 选项 类 TestOptions ,公开 两 个 string 类 型 的 属性 Iteml 和 Item2 。 


public class TestOptions 
{ 
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public string Item]l { get; set; } 
public string Item2 { get; set; } 
} 


步骤 3: 在 项 目 目 录 下 添加 一 个 JSON 文件 ,命名 为 configs. json。 


{ 
"urls": "http://localhost:16420", 
"environment": "Development", 
"myOptions": { 
"itenal”": "选项 A”, 
"item2" : "选项 一 B" 
} 
} 


urls 和 environment 两 个 字段 配置 的 是 WebHost,myOptions 字段 中 所 包含 的 内 容 才 
是 配置 TestOptions 选项 类 的 。 

步骤 4: 在 Main 方法 中 ,创建 并 启动 WebHost 实例 ,并 且 加 载 configs. json 文件 中 的 
配置 内 容 。 


var config = new ConfigurationBuilder() 
. SetBasePath(Directory. GetCurrentDirectory()) 
.RddJsonFile("configs. json", optional:true) 
.Build(); 

Var host = new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot(Directory. GetCurrentDirectory( )) 
.UseConfiguration(config) 
.UseStartup < Startup >() 
.Build(); 

host. Run( ); 


AddjsonFile 扩展 方法 的 optional 参数 用 于 指定 当前 要 添加 的 配置 源 是 否 为 可 选 。 本 
实例 中 将 该 参数 设置 为 true, 如 果 应 用 程序 找 不 到 configs. json 文件 ,就 忽略 它 , 不 会 发 生 
异常 。 

步骤 5: 修改 项 目 模板 默认 生成 的 Startup 类 ,从 构造 函数 中 接收 IConfiguration 类 型 
的 参数 ,以 便 获得 配置 信息 的 引用 。 


Private readonly IHostingEnvironment _env; 

private readonly IConfiguration config; 

public Startup( IHostingEnvironment env, IConfiguration config) 
{ 


_config = config; 


env = env; 
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步骤 6: 在 ConfigureServices 方法 中 调用 Configure < TOptions > 方法 来 初始 化 
TestOptions 选项 类 ,之 后 它 会 注册 到 服务 容器 中 。 


public void ConfigureServices(IServiceCollection services) 
{ 


services. AddMvc( ); 
services. Configure < TestOptions >(_config. GetSection( "myOptions")); 


: 


由 于 在 configs. json 文件 中 ,myOptions 字段 所 包含 的 内 容 才 是 反 序列 化 TestOptions 
类 所 需要 的 ,所 以 这 里 要 调用 GetSection 方法 获取 myOptions 字段 下 的 内 容 。 
步骤 7: 创建 Demo 控制 器 ,返回 一 个 视图 ,用 于 显示 选项 类 的 信息 。 


[Route("opts/[action]")] 
public class DemoController : Controller 
{ 
public ActionResult Default() => View(); 
} 


步骤 8: Default 视图 的 内 容 如 下 。 


@using Microsoft. Extensions. Options 
@using Demo 
@ inject IOptions < TestOptions > opt 


<html> 
<body> 
@! 
TestOptions o = opt?.Value; 
} 
@if(o == null) 


{ 
<div> 无 选项 信息 。</div> 
} 
else 
{ 
<div> 
<p> Item 1 : @o. Iteml </p> 
<p> Item 2 : @o. Item2 </p> 
</div> 
} LEY © localhost:16420/: 六 
</body> 
</html > Item 1 : 选项 -A 


步骤 9: 运行 应 用 程序 ,在 浏览 器 中 访问 http: | Item 2 :选项 -B 
//localhost: 16420/opts/default, 可 以 看 到 选项 类 初 
始 化 后 的 属性 值 ,如 图 17-5 所 示 。 本 1 多 项 类 的 初 短 妆 帮 
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注意 : 如 果 JSON 文件 中 包含 中 文字 符 , 在 应 用 程序 中 加 载 后 可 能 会 出 现 乱码 ,将 JSON 文 
件 以 UTF-8 编码 重新 保存 , 即 可 解决 问题 。 


17.3 实体 框架 


实例 377 为 实体 模型 设置 主键 


【导语 】 

实体 模型 会 映射 到 数据 库 中 的 表 , 而 数据 表 中 通常 需要 一 个 可 以 唯一 标识 每 条 记录 的 
字段 ,所 以 在 一 个 实体 类 中 ,应 该 至 少 选择 一 个 属性 作为 主键 。 在 实体 类 中 设置 主键 有 三 种 
方法 : 

(1) 将 类 中 的 某 个 属性 命名 为 Id 或 者 < 类 名 十 Id >, 会 被 自动 识别 为 主键 。 例 如 , 某 实 
体 类 命名 为 Student, 那 么 如 果 该 类 中 存在 命名 为 Id 或 者 StudentId 的 属性 ,就 可 以 将 其 自 
动 识别 为 Student 实体 的 主键 。 

(2) 通过 数据 批注 来 指定 。 数 据 批注 本 质 是 特性 (Attribute), 即 用 于 标注 实体 类 或 其 
成 员 上 的 特性 。 将 一 个 或 多 个 属性 标注 为 主键 可 以 应 用 Key 特性 (KeyAttribute 类 ) 。 

(3) 从 DbContext 类 派生 后 ,可 以 重 写 OnModelCreating 方法 ,再 通过 调用 HasKey 方 
法 来 设置 要 作为 主键 的 属性 。 

本 实例 将 分 别 对 以 上 三 种 方法 进行 演示 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 声明 实体 类 Car, 将 作为 主键 的 属性 命名 为 CarId, 它 会 自动 被 识别 为 主键 。 


public class Car 

public int CarId { get; set; } 

public string Color { get; set; } 

步骤 3: 声明 Employee 实体 类 ,使 用 Key 特性 标注 主键 。 


public class Employee 


[Key] 

public int EmpIdentity { get; set; } 
public int EmpAge { get; set; } 
public string EmpName { get; set; } 


步骤 4: 声明 Activity 实体 类 ,无 须 应 用 特性 , 稍 后 会 在 从 DbContext 类 派生 的 子 类 中 
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设置 主键 。 


public class Activity 
{ 
public Guid ActFlag { get; set; } 
public TimeSpan Period { get; set; } 
} 


步骤 5: 从 DbContext 类 中 派生 出 一 个 数据 上 下 文 类 型 ,将 上 面 定义 的 三 个 实体 分 别 
作为 公共 属性 公开 ,类 型 为 DbSet < TEntity >, 此 处 TEntity 为 具体 的 实体 类 型 。 


public class MYDbContext : DbContext 
{ 


public DbSet <Car > Cars { get; set; } 

public DbSet < Employee > Employees { get; set; } 

public DbSet < Activity> Activities { get; set; } 
} 


步骤 6: 重 写 OnModelCreating 方法 ,为 Activity 实体 设置 主键 。 


protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 

// 设置 Activity 类 的 ActFlag 属性 为 主键 

modelBuilder. Entity< Activity>().HasKey(nameof (Activity. ActFlag) ); 
} 


实例 378 ”迁移 实体 并 生成 数据 库 


【导语 】 

本 实例 将 演示 在 Visual Studio 开发 环境 中 使 用 Nuget 控制 台 命令 来 根据 实体 模型 生 
成 数据 库 的 过 程 。 

要 查看 EntityFramework Core(EF Core) 工 具 集 中 提供 的 命令 说 明 , 可 以 在 Nuget 控 
制 台 窗口 中 输入 如 下 命令 行 : 

get — help about_EntityFrameworkCore 
会 得 到 如 图 17-6 所 示 的 帮助 信息 。 

要 根据 已 编写 好 的 代码 (实体 类 以 及 从 DbContext 类 派生 的 自 定 义 数据 上 下 文 ) 生 成 
迁移 代码 (创建 数据 库 前 需要 迁移 代码 ) ,请 使 用 Add-Migration 命令 ,用 法 如 下 : 

Add— Migration [ — Name] < String > [ - OutputDir < String >] [ - Context < String >] [ - Project 

<String>] [ - StartupProject < String>] 

(1) -Name 参数 为 生成 的 迁移 版 本 指定 一 个 名 称 ,此 名 称 可 以 自 定义 ,-Name 可 以 省 
略 , 即 可 以 直接 在 首 个 参数 的 位 置 写 上 迁移 版 本 的 名 称 , 例 如 Add-Migration“Test”, 其 中 
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好 要 认 项 目 (): Demo 


Framework Core Package Manage 


k Core Package Manager Console Tool ect. net for 


图 17-6 ”EF Core 帮助 文档 


“Test” 就 是 生成 的 迁移 版 本 的 名 称 。 

(2) -OutputDir 参数 指定 生成 的 代码 文件 所 保存 的 目录 ,该 目录 的 路 径 是 相对 于 项 目 
根 目 录 的 。 此 参数 可 以 忽略 ,如 果 不 指定 ,默认 生成 的 目录 名 为 “Migrations”。 

(3) -Context 参数 指定 要 使 用 的 数据 上 下 文 , 即 从 DbContext 类 派生 的 子 类 名 称 。 

(4) -Project 参数 表示 要 使 用 的 应 用 程序 项 目 , 可 以 忽略 ,一般 是 当前 项 目 。 

(5) -StartupProject 参数 指定 当前 解决 方案 中 的 启动 项 目 。 此 参数 可 以 忽略 ,使 用 与 
解决 方案 配置 相同 的 启动 项 目 。 

假设 数据 上 下 文 的 类 型 名 称 为 CustDbContext, 以 下 命令 将 在 项 目的 CustMigVers 目 
录 下 生成 名 为 “Init” 的 迁移 代码 。 


Add— Migration "Init" ~ OutputDir "CustMigVers”- Context "CustDbContext" 


Add-Migration 命令 所 生成 的 迁移 代码 是 会 自动 积累 的 。 例 如 ,编写 完 相关 实体 和 数 
据 上 下 文 代码 后 ,执行 了 一 次 该 命令 ,生成 了 名 为 “MG 1” 的 迁移 代码 ; 之 后 由 于 项 目 需 求 ， 
对 实体 进行 了 更 改 , 实 体 类 增加 了 属性 ,于 是 需要 再 次 执行 Add-Migration 命令 生成 最 新 的 
迁移 代码 ,假设 第 二 次 生成 的 迁移 代码 名 为 “MG 2”; 最 终 ,“MG 1” 的 迁移 代码 不 会 被 删 
除 “MG 2” 仅 在 “MG 1” 的 基础 上 进行 修订 。 
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当然 ,如 果实 体 类 型 的 代码 被 大 面积 修改 (新 增 或 删除 类 型 等 ) ,就 会 考虑 把 先前 的 迁移 
版 本 删除 ,并 重新 生成 迁移 代码 。 此 时 可 以 使 用 Remove-Migration 命令 ,但 该 命令 不 会 一 
次 性 删除 所 有 迁移 (一 次 性 删除 容易 造成 误 删 ) ,每 执行 一 次 Remove-Migration 命令 ,只 会 
删除 最 新 的 一 个 迁移 版 本 。Remove-Migration 命令 用 法 如 下 : 


Remove 一 Migration [ ~ Force] [~ Context < String >] [ ~ Project < String >] [ ~ StartupProject 
<String>] 
(1) -Force 参数 可 选 , 如 果 迁 移 代 码 已 经 应 用 到 数据 库 , 可 以 将 其 进行 回 滚 。 
(2) -Context 参数 表示 要 使 用 的 数据 上 下 文 类 型 。 
(3) -Project 参数 与 -StartupProject 参数 的 功能 与 Add-Migration 命令 相同 。 
生成 迁移 代码 后 ,就 可 以 使 用 Update-Database 命令 来 生成 /更 新 数据 库 。Update-Database 
命令 用 法 如 下 : 
Update - Database [[ - Migration] < String >] [ - Context < String >] [ - Project < String >] 
[ - StartupProject < String >] 
-Migration 参数 (参数 名 可 以 省 略 ) 指 定 要 应 用 到 数据 库 的 迁移 名 称 ,如果 不 指定 ,将 应 用 所 
有 迁移 版 本 来 更 新 数据 库 。 删 除数 据 库 可 以 使 用 Drop-Database 命令 。 
【操作 流程 】 
步骤 1: 创建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 定义 实体 类 ,命名 为 User。 


public class User 

{ 
public int UID { get; set; } 
[Required(ErrorMessage = "用 户 名 是 必 填 项 ")] 
public string UserName { get; set; } 
[DataType(DataType. Password) ] 
public string Password { get; set; } 
public bool IsAdnmin { get; set; } 

} 


UID 属性 将 作为 主键 ,其 值 由 数据 库 自动 生成 ,创建 新 实例 时 无 须 赋值 。Required 特 
性 指定 UserName 属性 为 必 填 项 , 当 在 视图 页 面 上 未 输入 有 效 的 用 户 名 时 ,将 无 法 通过 
验证 。 

步骤 3: 从 DbContext 类 派生 一 个 子 类 ,并 将 User 实体 作为 数据 集合 公开 。 

public class UsContext : DbContext 

{ 


public DbSet< User > Users { get; set; } 
} 
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步骤 4: 重 写 DbContext 类 的 OnModelCreating 方法 ,并 设置 UID 属性 为 主键 。 


public class UsContext : DbContext 
{ 


protected override void OnModelCreating(ModelBuilder modelBuilder) 


{ 
modelBuilder. Entity< User >(). HasKey(u => u.UID); 


} 
’ 


步骤 5: 重 写 OnConfiguring 方法 ,配置 SQL Server 连接 字符 串 。 


public class UsContext : DbContext 
{ 


protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) 
{ 
optionsBuilder. UseSqlServer("server = (localdb)\\MSSQLLocalDB; database = CustDB" ) ; 
} 
} 
本 实例 使 用 的 是 轻 量 级 的 SQL Server LocalDB, 默认 的 引擎 实例 名 称 为 
“MSSQLLocalDB”, 可 以 通过 “(localdb)\\MSSQLLocalDB” 来 连接 服务 器 。 
步骤 6: 在 Startup. ConfigureServices 方法 中 将 自 定义 的 UsContext 类 注册 到 服务 容 
器 中 。 


public void ConfigureServices(IServiceCollection services) 
{ 

services. AddMvc( ); 

services. AddDbContext < UsContext >(); 


} 

步骤 7: 打开 Nuget 软件 包 管 理 器 的 控制 台 窗 口 ,输入 以 下 命令 为 UsContext 数据 上 
下 文 创建 一 个 迁移 版 本 。 

add — migration "ver 1" — OutputDir "MyMigras" — Context "UsContext" 


该 迁移 的 名 称 为 "ver 1”, 生 成 代码 的 输出 目录 是 项 目 根 目录 下 的 MyMigras 文件 夹 。 
步骤 8: 输入 以 下 命令 创建 数据 库 。 


update — database 


步骤 9: 定义 一 个 控制 器 ,用 于 查看 .新 增 和 删除 数据 , 详 见 代码 清单 17-1。 
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代码 清单 17-1 Home 控制 器 代码 


public class HomeController : Controller 


{ 


private readonly UsContext context; 
public HomeController(UsContext cxt) 
{ 


_Context = cxt; 


public ActionResult UserList() 
{ 


return View("default", _context. Users. ToList()); 


public ActionResult PostUser(User user) 
{ 
if (ModelState. IsValid) 
人 
_context. Users. Add(user); 
_context. SaveChanges( ); 
} 


return View("default", context. Users.TobList()); 


public ActionResult DeleteUser( int uid) 
{ 
User u = (from us in _context. Users 
where us. UID == uid 
select us). FirstOrDefault( ); 
if (u!= null) 
{ 
_context. Users. Remove(u); 
_context. SaveChanges( ); 
} 


return View("default", _context. Users. ToList()); 


步骤 10: 新 建 default 视图 ,用 于 展示 数据 记录 。 


@model List< User> 


< htm]l > 


<body> 


<div class = "container"> 
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<div> 
@await Component. InvokeAsync ("NewUser") 
</div> 
<hr /> 
<div> 
@if (Model == null || Model.Count == 0) 
{ 
<p> 无 用 户 信息 </p> 
h 
else 
! 
foreach (User us in Model) 
{ 
<p> 
用 户 ID:@us.UID< br /> 
用 户 名 :@us. UserName < br /> 
管理 员 :@(us. IsAdmin ? "是 " : " 否 ")<br /> 
<a asp- controller = "Home" asp— action = "DeleteUser" asp— route— 
uid="@us, UID"> 删 除 </a> 
</p> 
} 
F 
</div> 
</div> 
</body> 
</html > 


Model 是 从 控制 器 传递 进来 的 User 实例 列表 ,在 视图 中 通过 foreach 循环 显示 每 个 
User 实例 的 信息 。 其 中 < a > 元 素 用 于 执行 删除 操作 ,调用 的 是 控制 器 的 DeleteUser 方法 。 

步骤 11: 上 述 视图 中 引用 了 一 个 视图 组 件 ,用 于 新 增 User 信息 。NewUser 视图 组 件 
的 具体 代码 如 下 。 

public class NewUserViewComponent : ViewComponent 


{ 
public IViewComponentResult Invoke() 


{ 


return View("addUser", new User()); 


} 


注意 : 视图 组 件 所 关联 的 视图 会 合并 到 引用 它 的 视图 中 , 主 视图 中 指定 的 Model 是 User 对 
象 的 列表 ,而 视图 组 件 中 指定 的 Model 是 单个 User 实例 。 所 以 在 调用 视图 组 件 的 
View 方法 时 ,除了 指定 视图 名 称 外 ,还 要 传递 一 个 新 的 User 实例 作为 Model, 避 免 
ViewState 对 象 把 主 视 图 的 List < User > 传递 给 addUser 视图 的 Model 而 导致 类 型 
不 匹配 。 


520 去 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


步骤 12: 以 下 为 addUser 视图 的 内 容 。 


@model User 
< form asp— controller = "Home" asp— action = "PostUser"> 
< div class = "form— group"> 
< label > 用 户 名 :</label> 
< input asp — for = "UserName" class = "form— control" /> 
< span asp — validation - for = "UserName"></span> 
</div> 
< div class = "form - group"> 
< label > 密码 :</label > 
< input asp — for = "Password" class = "form - control" /> 
</div> 
< div class = "form— check"> 
< input asp ~ for = "IsAdmin" class = "form— check — input" /> 
< label class = "form - check - label"> 此 用 户 是 管理 员 </label > 
</div> 
<button type = "submit" class = "btn btn - primary"> 创 建新 用 户 </button > 
</form> 


步骤 13: 运行 应 用 程序 ,最 终 效果 如 图 17-7 所 示 。 


< 六 © localhost Home/PostUser i 大 下 四 图 
用 户 名 : 
Leff 
密码 : 
本 
此 用 户 是 管理 员 


用 户 ID: 25 

用 户 名 : Mr Liu 
管理 员 : 是 
删除 

用 户 ID: 26 
用 户 名 : Coolty 
管理 员 : 否 
删除 


图 17-7 User 对 象 列 表 视 图 
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步骤 14: 实例 中 所 创建 的 数据 库 一 般 用 于 测试 , 当 不 再 需要 该 数据 库 时 ,可 以 在 Nuget 
控制 台中 输入 Drop-Database 命令 来 删除 。 


drop— database 


实例 379 内存 数 据 库 


【导语 】 
内 存 数据 库 仅 存储 于 内 存 区 域 , 它 不 会 长 久 地 保存 数据 ,因此 内 存 数据 库 比 较 适合 存储 
应 用 程序 运行 期 间 的 一 些 临时 数据 。 
【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 项 目 。 
步骤 2: 定义 实体 类 。 
public class TestEnt 
{ 
public Guid AutoID { get; set; } 
public byte[ ] RandData { get; set; } 
} 


步骤 3: 自 定义 一 个 从 DbContext 派生 的 子 类 。 


public class MyDbContext :DbContext 
{ 
public MyDbContext (DbContextOptions < MYDbContext > opt) 
: base( opt) 
{ 


} 
public DbSet < TestEnt > TestEnts { get; set; } 


protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 
modelBuilder. Entity< TestEnt >(). HasKey(nameof (TestEnt. AutoID) ); 
} 
} 


实体 类 的 AutoID 属性 将 作为 数据 表 的 主键 。 

步骤 4: 在 Startup. ConfigureServices 方法 中 注册 上 述 自 定义 的 DbContext 类 ,并 且 启 
用 内 存 数据 库 。 

public void ConfigureServices( IServiceCollection services) 


{ 


services. AddMvc( ); 
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services. RddDbContext < MYDbContext >(o => 
{ 
o. UseInMemoryDatabase( "demo_db"); 
D); 
} 


“demo_db” 是 内 存 数据 库 的 名 字 , 该 名 字 可 以 自 定义 。 
步骤 $: 在 Main 方法 中 通过 WebHostBuilder 创建 WebHost 实例 。 


var host = new WebHostBuilder() 
.UseEnvironment (EnvironmentName. Development) 
.UseKestrel() 
.UseContentRoot (Directory. GetCurrentDirectory( )) 
.UseUrls("http://localhost:6910") 
,UseStartup < Startup >() 
.Build(); 


步骤 6: 在 调用 Run 方法 之 前 ,通过 以 下 代码 对 内 存 数 据 库 进行 初始 化 。 


using (IServiceScope scope = host.Services. CreateScope() ) 
{ 
MyDbContext context = scope.ServiceProvider.GetRequiredService < MyDbContext >(); 
Random rand = new Random(); 
for (int x = 0; x<5; x++) 
{ 
byte[ ] buffer = new byte[15]; 
rand. NextBytes( buffer); 
context. TestEnts. Add(new TestEnt 
{ 
RandData = buffer 
}); 
} 
context. SaveChanges( ); 
和 


CreateScope 方 法 可 以 返回 一 个 临时 对 象 的 引用 ,随后 通过 临时 对 象 创建 的 服务 实例 的 
生命 周期 将 在 此 scope 变量 的 作用 域 之 内 。 此 方案 可 以 临时 创建 MyDbContext 实例 来 写 
入 初始 化 数据 ,随后 MyDbContext 实例 就 会 被 释放 。 

步骤 7: 调用 Run 方法 来 启动 Web 服务 主机 。 


host. Run( ); 


步骤 8: 定义 一 个 Web API 控制 器 ,用 于 返回 内 存 数据 库 中 的 内 容 。 


[Route("[controller]")] 
public class DemoController : Controller 
{ 

private readonly MyDbContext context; 
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public DemoController (MyDbContext c) 
{ 
context = c; 


} 


[HttpGet] 
public ActionResult Get() 
{ 


return Json( context. TestEnts); 


} 


步骤 9: 运行 应 用 程序 ,以 HTTP-GET 方式 请 求 地 址 http: //localhost: 6910/demo 
以 下 数据 。 


将 返 


日 


"autoID": "e3dli9b6a— cd52 — 461c — 896b— e321a3b92064", 
"randData" : "yBDvZH2BdNc86fv0Jxrd" 


"autoID" : "86b20299 - 6e0f — 4137 — bb2b - 6a93dalcbd44", 
"randData" : "BoDt17s4vP4oR1XHgfe4" 


"autoID" : "04f8d983 - 5abl - 434a - bbla — f3678d5fal179"， 
"randData" : "8e9jESSzfrJeCgstUAp2" 


"autoID" : "74a35966 - 9d34 - 4754 - ac52 - 0cc2f085010b"， 
"randData" : "8oKnCay3WKtsRAwRxmEo" 


"autoID" : "fa838290 — 228c — 4374 — 9b6a — 78bf7dfb9398", 
"randData" : "uvLghPcLkBX1KYj0joyw" 


] 


实例 380 在 应 用 程序 运行 期 间 创 建 SQLite 数据 库 


【导语 】 

为 实体 模型 创建 数据 库 有 两 种 方案 : 在 Nuget 控制 台中 执行 Update-Database 命令 
(或 者 在 命令 行 中 执行 dotnet ef database update 命令 ) ,此 方案 是 在 应 用 程序 未 运行 的 情况 
下 执行 的 ; @ 通 过 编写 代码 ,在 应 用 程序 运行 期 间 创 建 数据 库 。 

DbContext 类 公开 了 Database 属性 ,其 类 型 为 DatabaseFacade, 该 类 型 公开 了 用 于 在 
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运行 阶段 创建 和 删除 数据 库 的 方法 。 

(1) EnsureCreated 方法 或 EnsureCreatedAsync 方法 。 如 果 目 标 数 据 库 (根据 连接 字 
符 串 获得 ) 不 存在 ,就 创建 新 数据 库 并 返回 true; 如 果 数 据 库 已 经 存在 , 则 返回 false。 

(2) EnsureDeleted 方法 或 EnsureDeletedAsync 方法 。 如 果 目 标 数据 库 已 存在 , 则 删 
除 该 数据 库 并 返回 true, 和 否则 返回 false。 

本 实例 演示 了 在 应 用 程序 运行 过 程 中 通过 调用 代码 来 创建 SQLite 数据 库 。 

【操作 流程 】 

步骤 1: 创建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 打开 Nuget 控制 台 窗口 ,输入 以 下 命令 来 安装 SQLite 数据 库 提供 的 与 程序 相 
关 的 程序 包 。 


Install - Package Microsoft, EntityFrameworkCore. Sqlite 


从 .NET Core SDK 2.1 开始 ,此 程序 包 并 不 在 AspNetCore. App 默认 包含 的 程序 包 列 
表 中 ,需要 手动 安装 。 
步骤 3: 定义 两 个 实体 类 。 


public class Album 
{ 
public int ID { get; set; } 
public string AlbumName { get; set; } 
public int Year { get; set; } 
public string Summary { get; set; } 
public List < Track > Tracks { get; set; } 
} 


public class Track 
{ 
public int ID { get; set; } 
public string Title { get; set; } 
public string Artist { get; set; } 
public double Duration { get; set; } 
} 


步骤 4: 定义 DbContext 的 派生 类 。 


public class DemoDbContext : DbContext 

{ 
public DbSet < Album > Albums { get; set; } 
public DbSet < Track > Tracks { get; set; } 


protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 

// 配置 主键 

modelBuilder. Entity< Album >().HasKey(s => s.1D); 
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modelBuilder. Entity< Track>().HasKey(t => t.1D); 

// 配置 为 一 对 多 的 关系 

modelBuilder. Entity< Album >(). HasMany(a => a.Tracks).WithOne(); 
} 


protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) 
{ 
optionsBuilder. UseSqlite("data source = TestData. db"); 
} 
} 


在 OnModelCreating 方法 中 ,首先 分 别 设置 两 个 实体 的 主键 ,然后 配置 两 个 实体 之 间 
的 关系 : Album 类 与 Track 类 是 “一 对 多 ”的 关系 。 
步骤 5: 在 Main 方法 中 ,配置 并 创建 WebHost 实例 。 


var host = new WebHostBuilder() 
.UseKestrel() 
.UseEnvironment (EnvironmentName. Development) 
.UseContentRoot (Directory. GetCurrentDirectory( )) 
.UseUrls("http://localhost:9133") 
.UseStartup< Startup >() 
.Build(); 


步骤 6: 为 了 生成 测试 用 的 数据 ,在 运行 WebHost 实例 前 ,可 以 先 创建 数据 库 , 然 后 再 
向 数据 库 写 人 记录 。 


using(IServiceScope scope = host.Services. CreateScope() ) 
{ 
DemoDbContext context = scope. ServiceProvider. GetRequiredService < DemoDbContext >(); 
context. Database. EnsureDeleted( ); 
if (context. Database. EnsureCreated( )) 
{ 
// 如 果 是 新 创建 的 数据 库 , 写 人 一 些 测试 数据 
Album abl = new Album(); 
abl. AlbumName = "专辑 01"; 
abl. Year = 2010; 
abl. Summary = "冬日 里 的 唱 响 "; 
abl. Tracks = new List<Track> 
new Track 
{ 
Title = "曲目 1"， 
Artist = " 老 高 "， 
Duration = 212.3d 
}, 
new Track 
{ 
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Title = "曲目 2"， 
Artist = "大 觅 "， 
Duration = 179.62d 
} 
}; 
context. Albums. Add(abl); 
Album ab2 = new Album(); 
ab2. AlbumName = "专辑 02"; 
ab2.Year = 2016; 
ab2. Summary = "最 具 风 雅 的 弦 乐 "; 
ab2.Tracks = new List<Track> 
{ 


new Track 


Title = "曲目 1"，, 
Artist = " 张 K", 
Duration = 230.301d 


new Track 


Title = "曲目 2"， 

Artist = "Coh", 

Duration = 197d 
’ 


new Track 


Title = "曲目 3"， 
Artist = "L.Joke", 
Duration = 265.99d 


}; 
context. Albums. Add(ab2); 
context. SaveChanges( ); 


} 


先 调用 EnsureDeleted 方法 以 确保 删除 已 有 的 数据 库 , 再 调用 EnsureCreated 方法 创建 
新 的 数据 库 。 
步骤 7: 创建 一 个 API 控制 器 ,返回 Album 实体 列表 (JSON 格式 ) 。 


[Route("albums")] 
public class DemoController : Controller 
{ 
readonly DemoDbContext context; 
public DemoController(DemoDbContext cxt) 
{ 
context = cxt; 
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} 


[HttpGet] 

public ActionResult Get() 

{ 
var albums = context.RAlbums. Include(a =>a.Tracks); 
return Json(albums) ; 


} 


Album 实体 类 的 Tracks 属性 属于 “导航 属性 ”, 它 包含 与 该 实体 有 关联 的 Track 对 象 。 
这 里 必须 调用 Include 方法 ,否则 Tracks 属性 将 返回 null( 默 认 不 会 加 载 导航 属性 所 包含 的 
数据 )。 

步骤 8: 运行 应 用 程序 ,访问 地 址 http: //localhost: 9133/albums 可 获取 Album 对 象 
列表 。 返 回 的 JSON 内 容 如 下 。 


[ 


wid": 1, 
"albumName" : "专辑 01"， 
"year": 2010, 
"summary": "冬日 里 的 唱 响 "， 
"tracks": [ 
{ 
wks 
"Eee "用 时 1"; 
"ertist": “ 涛 高 ”， 
"duration": 212.3 


"gr 

eitiers "2 
"artist": "大 鹏 "， 
"duration" : 179. 62 


2 

"albumName" : "专辑 02"， 
"year": 2016, 

"summary": "最 具 风 雅 的 弦 乐 "， 


"tracks": [ 
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We 

"title": "曲目 1"， 
optint es 各 涟 "7 
"duration": 230. 301 


"1 
"title": "曲目 2"， 
"artist": "Coh", 


"duration": 197 


wa 

"title": "曲目 3"， 
"artist": "L. Joke", 
"duration": 265.99 


